Этот скрипт расширяет возможности гибких бюджетов для запуска нескольких аккаунтов в рамках одного управляющего аккаунта. Гибкие бюджеты позволяют ежедневно динамически корректировать бюджет вашей кампании с помощью специальной схемы распределения бюджета.
Скрипт считывает электронную таблицу для каждой указанной учетной записи/кампании и соответствующего бюджета (связанного с датой начала и датой окончания), находит кампанию, рассчитывает бюджет на текущий день, устанавливает его в качестве дневного бюджета кампании и записывает результат в электронная таблица. Это не затронет кампании, не указанные в таблице.
Как это работает
Скрипт работает так же, как и скрипт гибкого бюджета для одного аккаунта. Единственная дополнительная функциональность заключается в том, что она поддерживает несколько учетных записей в указанной электронной таблице.
В первых двух столбцах указывается кампания, для которой рассчитывается бюджет, в следующих трех — информация о бюджете, а в последней — результат выполнения.
Идентификатор аккаунта должен быть аккаунтом рекламодателя, а не управляющего аккаунта.
У вас может быть несколько бюджетов для одной и той же учетной записи/кампании, но убедитесь, что у вас одновременно есть только один активный бюджет, иначе новый расчет бюджета может перезаписать старый.
Если в таблице не указан аккаунт/кампания, скрипт не установит для него гибкий бюджет.
Тестирование бюджетных стратегий
Сценарий включает в себя код тестирования для имитации последствий бега в течение нескольких дней. Это дает вам лучшее представление о том, что происходит, когда сценарий запланирован на ежедневное выполнение в течение определенного периода времени.
По умолчанию этот скрипт имитирует равномерное распределение бюджета в размере 500 долларов США, потраченных за 10 дней.
Вы можете запустить код тестирования, вызвав testBudgetStrategy вместо setNewBudget в основном методе:
function main() {
testBudgetStrategy(calculateBudgetEvenly, 10, 500);
// setNewBudget(calculateBudgetWeighted);
}
Вызов функции setNewBudget закомментирован, что указывает на то, что скрипт выполняет тестовый код. Вот результат примера:
Day 1.0 of 10.0, new budget 50.0, cost so far 0.0
Day 2.0 of 10.0, new budget 50.0, cost so far 50.0
Day 3.0 of 10.0, new budget 50.0, cost so far 100.0
Day 4.0 of 10.0, new budget 50.0, cost so far 150.0
Day 5.0 of 10.0, new budget 50.0, cost so far 200.0
Day 6.0 of 10.0, new budget 50.0, cost so far 250.0
Day 7.0 of 10.0, new budget 50.0, cost so far 300.0
Day 8.0 of 10.0, new budget 50.0, cost so far 350.0
Day 9.0 of 10.0, new budget 50.0, cost so far 400.0
Day 10.0 of 10.0, new budget 50.0, cost so far 450.0
Day 11.0 of 10.0, new budget 0.0, cost so far 500.0
Каждый день рассчитывается новый бюджет, чтобы обеспечить его равномерное расходование каждый день. После превышения первоначальных бюджетных ассигнований бюджет обнуляется, чтобы остановить расходы.
Вы можете изменить используемую бюджетную стратегию, изменив используемую функцию или изменив саму функцию. Сценарий поставляется с двумя готовыми стратегиями: calculateBudgetEvenly и calculateBudgetWeighted ; предыдущий пример только что проверил первый — обновите строку testBudgetStrategy , чтобы использовать второй:
testBudgetStrategy(calculateBudgetWeighted, 10, 500);
Нажмите «Предварительный просмотр» и проверьте выходные данные регистратора. Обратите внимание, что эта бюджетная стратегия выделяет меньше бюджета в начале периода и увеличивает его в течение следующих нескольких дней.
Этот метод тестирования можно использовать для имитации изменений в функциях расчета бюджета и опробовать собственный подход к распределению бюджета.
Распределение бюджета
Давайте более внимательно рассмотрим бюджетную стратегию calculateBudgetWeighted :
// One calculation logic that distributes remaining budget in a weighted manner
function calculateBudgetWeighted(costSoFar, totalBudget, daysSoFar, totalDays) {
const daysRemaining = totalDays - daysSoFar;
const budgetRemaining = totalBudget - costSoFar;
if (daysRemaining <= 0) {
return budgetRemaining;
} else {
return budgetRemaining / (2 * daysRemaining - 1);
}
}
Эта функция принимает следующие аргументы:
-
costSoFar: сколько затрат на эту кампанию накопилось сstartDateдо сегодняшнего дня. -
totalBudget: сколько потратить сstartDateдоendDate. -
daysSoFar: сколько дней прошло сstartDateдо сегодняшнего дня. -
totalDays: Общее количество дней междуstartDateиendDate.
Вы можете написать свою собственную функцию, если она принимает эти аргументы. Используя эти значения, вы можете сравнить, сколько денег вы потратили на данный момент, с тем, сколько придется потратить в целом, и определить, где вы находитесь в настоящее время в пределах графика всего бюджета.
В частности, эта бюджетная стратегия определяет, сколько осталось бюджета ( totalBudget - costSoFar ), и делит его на удвоенное количество оставшихся дней. Это взвешивает распределение бюджета к концу кампании. Используя стоимость с момента startDate , он также учитывает «медленные дни», когда вы не тратите весь установленный вами бюджет.
Бюджетирование в производстве
Когда вы будете довольны своей бюджетной стратегией, вам нужно будет внести несколько изменений, прежде чем вы сможете запланировать ежедневный запуск этого сценария.
Сначала обновите таблицу, указав учетную запись, кампанию, бюджет, дату начала и дату окончания — по одной строке для каждого бюджета кампании.
- Идентификатор аккаунта : идентификатор аккаунта (в формате xxx-xxx-xxxx) кампании, к которой нужно применить бюджетную стратегию.
- Название кампании : название кампании, к которой будет применена бюджетная стратегия.
- Дата начала : дата начала вашей бюджетной стратегии. Это должна быть текущая дата или день в прошлом.
- Дата окончания : последний день, когда вы хотите размещать рекламу с этим бюджетом.
- Общий бюджет : общая сумма, которую вы пытаетесь потратить. Это значение указывается в валюте аккаунта и может быть превышено в зависимости от запланированного запуска сценария.
Далее отключите тест и включите логику фактического изменения бюджета:
function main() {
// testBudgetStrategy(calculateBudgetEvenly, 10, 500);
setNewBudget(calculateBudgetWeighted);
}
Результат каждой кампании записывается в столбце «Результат выполнения» .
Планирование
Запланируйте запуск этого сценария ежедневно, в полночь или вскоре после нее по местному часовому поясу, чтобы максимально распределить бюджет предстоящего дня. Однако обратите внимание, что полученные данные отчетов, такие как стоимость, могут задерживаться примерно на 3 часа, поэтому параметр costSoFar может ссылаться на вчерашнюю сумму для сценария, запуск которого запланирован после полуночи.
Настраивать
Нажмите кнопку ниже, чтобы создать скрипт в своем аккаунте Google Рекламы.
Нажмите кнопку ниже, чтобы сделать копию таблицы шаблона.
Обновите
spreadsheet_urlв вашем скрипте.Запланируйте запуск сценария ежедневно .
Исходный код
// Copyright 2015, Google Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
/**
* @name MCC Flexible Budgets
*
* @overview The MCC Flexible Budgets script dynamically adjusts campaign budget
* daily for accounts under an MCC account with a custom budget distribution
* scheme. See
* https://developers.google.com/google-ads/scripts/docs/solutions/manager-flexible-budgets
* for more details.
*
* @author Google Ads Scripts Team [adwords-scripts@googlegroups.com]
*
* @version 2.1
*
* @changelog
* - version 2.1
* - Split into info, config, and code.
* - version 2.0
* - Updated to use new Google Ads scripts features.
* - version 1.0.4
* - Add support for video and shopping campaigns.
* - version 1.0.3
* - Added validation for external spreadsheet setup.
* - version 1.0.2
* - Fix a minor bug in variable naming.
* - Use setAmount on the budget instead of campaign.setBudget.
* - version 1.0.1
* - Improvements to time zone handling.
* - version 1.0
* - Released initial version.
*/
/**
* Configuration to be used for the Flexible Budgets script.
*/
CONFIG = {
// URL of the default spreadsheet template. This should be a copy of
// https://docs.google.com/spreadsheets/d/17wocOgrLeRWF1Qi_BjEigCG0qVMebFHrbUS-Vk_kpLg/copy
// Make sure the sheet is owned by or shared with same Google user executing the script
'spreadsheet_url': 'YOUR_SPREADSHEET_URL',
'advanced_options': {
// Please fix the following variables if you need to reformat the
// spreadsheet
// column numbers of each config column. Column A in your spreadsheet has
// column number of 1, B has number of 2, etc.
'column': {
'accountId': 2,
'campaignName': 3,
'startDate': 4,
'endDate': 5,
'totalBudget': 6,
'results': 7
},
// Actual config (without header and margin) starts from this row
'config_start_row': 5
}
};
const SPREADSHEET_URL = CONFIG.spreadsheet_url;
const COLUMN = CONFIG.advanced_options.column;
const CONFIG_START_ROW = CONFIG.advanced_options.config_start_row;
function main() {
// Uncomment the following function to test your budget strategy function
// testBudgetStrategy(calculateBudgetEvenly, 10, 500);
setNewBudget(calculateBudgetWeighted);
}
// Core logic for calculating and setting campaign daily budget
function setNewBudget(budgetFunc) {
console.log(`Using spreadsheet - ${SPREADSHEET_URL}.`);
const spreadsheet = validateAndGetSpreadsheet(SPREADSHEET_URL);
spreadsheet.setSpreadsheetTimeZone(AdsApp.currentAccount().getTimeZone());
const sheet = spreadsheet.getSheets()[0];
const endRow = sheet.getLastRow();
const mccAccount = AdsApp.currentAccount();
sheet.getRange(2, 6, 1, 2).setValue(mccAccount.getCustomerId());
const today = new Date();
for (let i = CONFIG_START_ROW; i <= endRow; i++) {
console.log(`Processing row ${i}`);
const accountId = sheet.getRange(i, COLUMN.accountId).getValue();
const campaignName = sheet.getRange(i, COLUMN.campaignName).getValue();
const startDate = new Date(sheet.getRange(i, COLUMN.startDate).getValue());
const endDate = new Date(sheet.getRange(i, COLUMN.endDate).getValue());
const totalBudget = sheet.getRange(i, COLUMN.totalBudget).getValue();
const resultCell = sheet.getRange(i, COLUMN.results);
const accountIter = AdsManagerApp.accounts().withIds([accountId]).get();
if (!accountIter.hasNext()) {
resultCell.setValue('Unknown account');
continue;
}
const account = accountIter.next();
AdsManagerApp.select(account);
const campaign = getCampaign(campaignName);
if (!campaign) {
resultCell.setValue('Unknown campaign');
continue;
}
if (today < startDate) {
resultCell.setValue('Budget not started yet');
continue;
}
if (today > endDate) {
resultCell.setValue('Budget already finished');
continue;
}
const costSoFar = campaign
.getStatsFor(
getDateStringInTimeZone('yyyyMMdd', startDate),
getDateStringInTimeZone('yyyyMMdd', endDate))
.getCost();
const daysSoFar = datediff(startDate, today);
const totalDays = datediff(startDate, endDate);
const newBudget = budgetFunc(costSoFar, totalBudget, daysSoFar, totalDays);
campaign.getBudget().setAmount(newBudget);
console.log(
`AccountId=${accountId}, CampaignName=${campaignName}, ` +
`StartDate=${startDate}, EndDate=${endDate}, ` +
`CostSoFar=${costSoFar}, DaysSoFar=${daysSoFar}, ` +
`TotalDays=${totalDays}, NewBudget=${newBudget}'`);
resultCell.setValue(`Set today's budget to ${newBudget}`);
}
// update "Last execution" timestamp
sheet.getRange(1, 3).setValue(today);
AdsManagerApp.select(mccAccount);
}
// One calculation logic that distributes remaining budget evenly
function calculateBudgetEvenly(costSoFar, totalBudget, daysSoFar, totalDays) {
const daysRemaining = totalDays - daysSoFar;
const budgetRemaining = totalBudget - costSoFar;
if (daysRemaining <= 0) {
return budgetRemaining;
} else {
return budgetRemaining / daysRemaining;
}
}
// One calculation logic that distributes remaining budget in a weighted manner
function calculateBudgetWeighted(costSoFar, totalBudget, daysSoFar, totalDays) {
const daysRemaining = totalDays - daysSoFar;
const budgetRemaining = totalBudget - costSoFar;
if (daysRemaining <= 0) {
return budgetRemaining;
} else {
return budgetRemaining / (2 * daysRemaining - 1);
}
}
// Test function to verify budget calculation logic
function testBudgetStrategy(budgetFunc, totalDays, totalBudget) {
let daysSoFar = 0;
let costSoFar = 0;
while (daysSoFar <= totalDays + 2) {
const newBudget = budgetFunc(costSoFar, totalBudget, daysSoFar, totalDays);
console.log(
`Day ${daysSoFar + 1} of ${totalDays}, ` +
`new budget ${newBudget}, cost so far ${costSoFar}`);
costSoFar += newBudget;
daysSoFar += 1;
}
}
// Return number of days between two dates, rounded up to nearest whole day.
function datediff(from, to) {
const millisPerDay = 1000 * 60 * 60 * 24;
return Math.ceil((to - from) / millisPerDay);
}
// Produces a formatted string representing a given date in a given time zone.
function getDateStringInTimeZone(format, date, timeZone) {
date = date || new Date();
timeZone = timeZone || AdsApp.currentAccount().getTimeZone();
return Utilities.formatDate(date, timeZone, format);
}
/**
* Finds a campaign by name, whether it is a regular, video, or shopping
* campaign, by trying all in sequence until it finds one.
*
* @param {string} campaignName The campaign name to find.
* @return {Object} The campaign found, or null if none was found.
*/
function getCampaign(campaignName) {
const selectors =
[AdsApp.campaigns(), AdsApp.videoCampaigns(), AdsApp.shoppingCampaigns()];
for (const selector of selectors) {
const campaignIter =
selector.withCondition(`CampaignName = "${campaignName}"`).get();
if (campaignIter.hasNext()) {
return campaignIter.next();
}
}
return null;
}
/**
* Validates the provided spreadsheet URL to make sure that it's set up
* properly. Throws a descriptive error message if validation fails.
*
* @param {string} spreadsheeturl The URL of the spreadsheet to open.
* @return {Spreadsheet} The spreadsheet object itself, fetched from the URL.
* @throws {Error} If the spreadsheet URL hasn't been set
*/
function validateAndGetSpreadsheet(spreadsheeturl) {
if (spreadsheeturl == 'YOUR_SPREADSHEET_URL') {
throw new Error(
'Please specify a valid Spreadsheet URL. You can find' +
' a link to a template in the associated guide for this script.');
}
return SpreadsheetApp.openByUrl(spreadsheeturl);
}