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

نماد ابزارها

Google Ads به شما امکان می دهد برای هر کمپین بودجه روزانه تعیین کنید. با این حال، برخی از ابتکارات بازاریابی هزینه ثابت مرتبط با آنها را خواهند داشت. به عنوان مثال، "من می خواهم 5000 دلار برای فروش پاییزی خود خرج کنم". استراتژی مناقصه به شما کنترلی بر نحوه مصرف بودجه روزانه می دهد، اما کنترلی بر نحوه مصرف بودجه در طول کمپین ندارد.

به عنوان مثال، اگر بخواهیم فقط 5000 دلار برای تبلیغ فروش پاییزی خود خرج کنیم و بخواهیم 10 روز تبلیغ کنیم، می توانیم بودجه روزانه 500 دلار را برای استفاده از کل بودجه تعیین کنیم. با این حال، فرض بر این است که ما کل مبلغ را هر روز خرج خواهیم کرد و مایلیم آن را به طور مساوی خرج کنیم. نمی توان به Google Ads گفت که می خواهید بخش عمده ای از بودجه خود را در چند روز گذشته خرج کنید.

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

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

تست استراتژی های بودجه

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

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

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

روی Preview کلیک کنید و خروجی لاگر را بررسی کنید. توجه داشته باشید که این استراتژی بودجه بودجه کمتری را در اوایل دوره اختصاص می‌دهد و در چند روز گذشته بیشتر اختصاص می‌دهد.

شما می توانید از این روش تست برای شبیه سازی تغییرات در توابع محاسبه بودجه استفاده کنید و رویکرد خود را برای توزیع بودجه امتحان کنید.

اختصاص بودجه

استراتژی بودجه 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);
}

برنامه ریزی

این اسکریپت را طوری برنامه ریزی کنید که روزانه، یا کمی بعد از نیمه شب در منطقه زمانی محلی اجرا شود تا بودجه روز آینده را تا حد امکان هدایت کنید. با این حال، توجه داشته باشید که داده‌های گزارش‌های بازیابی‌شده مانند هزینه ممکن است حدود 3 ساعت به تاخیر بیفتد، بنابراین پارامتر costSoFar ممکن است به کل دیروز برای اسکریپتی که قرار است بعد از نیمه‌شب اجرا شود، ارجاع دهد.

برپایی

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

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

  • اسکریپت را ذخیره کنید و روی دکمه Preview کلیک کنید. این اسکریپت (به طور پیش فرض) یک استراتژی بودجه را با 500 دلار در مدت 10 روز شبیه سازی می کند. خروجی لاگر روز شبیه سازی شده، بودجه تخصیص یافته برای آن روز و کل مبلغ هزینه شده تا به امروز را منعکس می کند.

کد منبع

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