Гибкий бюджет (один аккаунт)

This script is for a single account. For operating on multiple accounts in a Manager Account, use the Manager Account version of the script.

В AdWords можно задать дневной бюджет кампании. Однако если расходы на кампанию в целом ограничены, вы не сможете настроить распределение бюджета по дням в рамках стратегии назначения ставок.

Пример: вы хотите провести кампанию длительностью 10 дней с совокупным бюджетом 5000 долларов США. Задав дневной бюджет на уровне 500 долларов США, вы уложитесь в эту сумму, но по умолчанию средства будут расходоваться равномерно. Перенести большую часть расходов на последние дни кампании с помощью инструментов AdWords не получится.

Предлагаемый скрипт позволяет настроить собственную схему распределения средств, чтобы динамически корректировать дневной бюджет кампании.

Принцип работы

Тестирование бюджетной стратегии

Скрипт содержит код, позволяющий смоделировать и оценить последствия его выполнения на протяжении нескольких дней.

По умолчанию моделируется равномерное распределение бюджета в 500 долларов США на десятидневный период.

function main() {
  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
//  setNewBudget(calculateBudgetEvenly, CAMPAIGN_NAME, TOTAL_BUDGET, START_DATE, END_DATE);
}

В тестовом коде вызов функции 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:

function calculateBudgetWeighted(costSoFar, totalBudget, daysSoFar, totalDays) {
  var daysRemaining = totalDays - daysSoFar;
  var budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / (2 * daysRemaining - 1) ;
  }
}

Эта функция принимает четыре аргумента:

  • costSoFar – расходы кампании в период с START_DATE по сегодняшний день.
  • totalBudget – совокупный бюджет на период с START_DATE по END_DATE.
  • daysSoFar – число дней с START_DATE по сегодняшний день.
  • totalDays – общая продолжительность периода с START_DATE по END_DATE в днях.

Все аргументы являются обязательными для пользовательских реализаций этой функции. Они позволяют сравнивать объем потраченных на текущий момент средств с общим бюджетом и следить за распределением расходов.

Эта функция рассчитывает оставшийся объем бюджета (totalBudget - costSoFar) и делит его на удвоенное число дней до окончания кампании. При этом основная часть бюджета распределяется на последние дни кампании. Также учитываются дни, когда дневной бюджет не был израсходован полностью.

Распределение бюджета на практике

После определения подходящей стратегии настройте скрипт для ежедневного выполнения.

Задайте следующие константы в начале файла:

  • START_DATE – дата начала реализации стратегии (не позднее текущей).
  • END_DATE – дата окончания рекламной кампании.
  • TOTAL_BUDGET – совокупный бюджет кампании в валюте аккаунта. Это значение может превышаться в зависимости от настроек планирования.
  • CAMPAIGN_NAME – название кампании, к которой будет применяться стратегия.

Затем отключите режим тестирования и определите логику изменения фактического бюджета:

function main() {
//  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  setNewBudget(calculateBudgetWeighted, CAMPAIGN_NAME, TOTAL_BUDGET, START_DATE, END_DATE);
}

Планирование

Для максимально эффективного распределения средств планируйте выполнение скрипта ежедневно в районе полуночи по местному времени. Обратите внимание, что из-за возможной трехчасовой задержки с обновлением некоторых данных отчетов параметр costSoFar может ссылаться на статистику предшествующего дня.

Настройка

  • Создайте новый скрипт с приведенным ниже кодом.
  • Сохраните скрипт и нажмите кнопку Просмотр. По умолчанию моделируется распределение за десятидневный период с дневным бюджетом в 500 долларов США. В журнале будут отражаться сведения о бюджете на конкретный день, а также о средствах, израсходованных на текущий момент.

Код

// 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 Flexible Budgets
 *
 * @overview The Flexible budgets script dynamically adjusts campaign budget for
 *     an advertiser account with a custom budget distribution scheme on a daily
 *     basis. See
 *     https://developers.google.com/adwords/scripts/docs/solutions/flexible-budgets
 *     for more details.
 *
 * @author AdWords Scripts Team [adwords-scripts@googlegroups.com]
 *
 * @version 1.0.3
 *
 * @changelog
 * - version 1.0.3
 *   - Add support for video and shopping campaigns.
 * - version 1.0.2
 *   - Use setAmount on the budget instead of campaign.setBudget.
 * - version 1.0.1
 *   - Improvements to time zone handling.
 * - version 1.0
 *   - Released initial version.
 */

var START_DATE = new Date('May 1, 2016 0:00:00 -0500');
var END_DATE = new Date('June 1, 2016 0:00:00 -0500');
var TOTAL_BUDGET = 500;
var CAMPAIGN_NAME = 'Special Promotion';

function main() {
  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
//  setNewBudget(calculateBudgetEvenly, CAMPAIGN_NAME, TOTAL_BUDGET,
//      START_DATE, END_DATE);
}

function setNewBudget(budgetFunction, campaignName, totalBudget, start, end) {
  var today = new Date();
  if (today < start) {
    Logger.log('Not ready to set budget yet');
    return;
  }
  var campaign = getCampaign(campaignName);
  var costSoFar = campaign.getStatsFor(
      getDateStringInTimeZone('yyyyMMdd', start),
      getDateStringInTimeZone('yyyyMMdd', end)).getCost();
  var daysSoFar = datediff(start, today);
  var totalDays = datediff(start, end);
  var newBudget = budgetFunction(costSoFar, totalBudget, daysSoFar, totalDays);
  campaign.getBudget().setAmount(newBudget);
}

function calculateBudgetEvenly(costSoFar, totalBudget, daysSoFar, totalDays) {
  var daysRemaining = totalDays - daysSoFar;
  var budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / daysRemaining;
  }
}

function calculateBudgetWeighted(costSoFar, totalBudget, daysSoFar,
    totalDays) {
  var daysRemaining = totalDays - daysSoFar;
  var budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / (2 * daysRemaining - 1);
  }
}

function testBudgetStrategy(budgetFunc, totalDays, totalBudget) {
  var daysSoFar = 0;
  var costSoFar = 0;
  while (daysSoFar <= totalDays + 2) {
    var newBudget = budgetFunc(costSoFar, totalBudget, daysSoFar, totalDays);
    Logger.log('Day %s of %s, new budget %s, cost so far %s', daysSoFar + 1,
        totalDays, newBudget, costSoFar);
    costSoFar += newBudget;
    daysSoFar += 1;
  }
}

/**
 * Returns number of days between two dates, rounded up to nearest whole day.
 */
function datediff(from, to) {
  var millisPerDay = 1000 * 60 * 60 * 24;
  return Math.ceil((to - from) / millisPerDay);
}

function getDateStringInTimeZone(format, date, timeZone) {
  date = date || new Date();
  timeZone = timeZone || AdWordsApp.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) {
    var selectors = [AdWordsApp.campaigns(), AdWordsApp.videoCampaigns(),
      AdWordsApp.shoppingCampaigns()];
  for(var i = 0; i < selectors.length; i++) {
    var campaignIter = selectors[i].
        withCondition('CampaignName = "' + campaignName + '"').
        get();
    if (campaignIter.hasNext()) {
      return campaignIter.next();
    }
  }
  throw new Error('Could not find specified campaign: ' + campaignName);
}

Looking for the Manager Account (MCC) version? Click here

Оставить отзыв о...

Текущей странице
Скрипты AdWords
Скрипты AdWords