بودجه های انعطاف پذیر - حساب واحد

آیکون ابزارها

گوگل ادز به شما اجازه می‌دهد برای هر کمپین، مبلغ بودجه روزانه تعیین کنید. با این حال، برخی از طرح‌های بازاریابی هزینه ثابتی دارند؛ برای مثال، «من می‌خواهم تا قبل از فروش پاییزی‌مان ۵۰۰۰ دلار هزینه کنم». استراتژی پیشنهاد قیمت به شما امکان کنترل بر نحوه خرج کردن بودجه روزانه را می‌دهد، اما هیچ کنترلی بر نحوه مصرف بودجه در طول کمپین ندارد.

برای مثال، اگر بخواهیم فقط ۵۰۰۰ دلار برای تبلیغ فروش پاییزی خود هزینه کنیم و بخواهیم به مدت ۱۰ روز تبلیغ کنیم، می‌توانیم بودجه روزانه ۵۰۰ دلار تعیین کنیم تا کل بودجه مصرف شود. با این حال، این فرض را در نظر می‌گیریم که ما هر روز کل مبلغ را خرج خواهیم کرد و می‌خواهیم آن را به طور مساوی خرج کنیم. نمی‌توان به گوگل ادز گفت که می‌خواهید بخش عمده بودجه خود را در چند روز گذشته خرج کنید.

این اسکریپت به صورت پویا بودجه کمپین شما را روزانه با یک طرح توزیع بودجه سفارشی تنظیم می‌کند.

چگونه کار می‌کند؟

آزمایش استراتژی‌های بودجه‌بندی

این اسکریپت شامل تعدادی کد آزمایشی برای شبیه‌سازی اثرات اجرا به مدت چند روز است. این به شما ایده بهتری از آنچه ممکن است هنگام اجرای روزانه اسکریپت در یک دوره زمانی خاص رخ دهد، می‌دهد.

به طور پیش‌فرض، این اسکریپت توزیع بودجه‌ی یکنواخت ۵۰۰ دلار خرج شده در طول ۱۰ روز را شبیه‌سازی می‌کند.

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) {
  const daysRemaining = totalDays - daysSoFar;
  const 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 ، «روزهای کند» را نیز در نظر می‌گیرد که در آن‌ها بودجه تعیین‌شده به طور کامل خرج نشده است.

بودجه واقعی

وقتی از استراتژی بودجه‌بندی خود راضی بودید، قبل از برنامه‌ریزی برای اجرای روزانه‌ی این اسکریپت، باید چند تغییر ایجاد کنید.

ابتدا، ثابت‌های بالای فایل را به‌روزرسانی کنید:

  • 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 ممکن است به مجموع دیروز برای اسکریپتی که قرار است بعد از نیمه‌شب اجرا شود، اشاره داشته باشد.

راه‌اندازی

  • برای ایجاد اسکریپت در حساب گوگل ادز خود، روی دکمه کلیک کنید.

    نصب قالب اسکریپت

  • اسکریپت را ذخیره کنید و روی دکمه پیش‌نمایش کلیک کنید. این اسکریپت (به‌طور پیش‌فرض) یک استراتژی بودجه‌بندی با ۵۰۰ دلار را طی ۱۰ روز شبیه‌سازی می‌کند. خروجی ثبت‌کننده، روز شبیه‌سازی‌شده، بودجه اختصاص‌یافته برای آن روز و کل مبلغ خرج‌شده تا به امروز را نشان می‌دهد.

کد منبع

// 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/google-ads/scripts/docs/solutions/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.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.
 */

/**
 * Configuration to be used for the Flexible Budgets script.
 */

CONFIG = {
  'total_budget': 500,
  'campaign_name': 'Special Promotion',
  'start_date': 'November 1, 2021 0:00:00 -0500',
  'end_date': 'December 1, 2021 0:00:00 -0500'
};

const TOTAL_BUDGET = CONFIG.total_budget;
const CAMPAIGN_NAME = CONFIG.campaign_name;
const START_DATE = new Date(CONFIG.start_date);
const END_DATE = new Date(CONFIG.end_date);

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

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

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

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);
  }
}

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;
  }
}

/**
 * Returns 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);
}

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();
    }
  }
  throw new Error(`Could not find specified campaign: ${campaignName}`);
}