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

نماد ابزارها

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

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

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

روش کار

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

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

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

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

راه‌اندازی

  • روی دکمه کلیک کنید تا دستورات در حساب Google Ads شما ایجاد شود.

    نصب کردن الگوی دستورگان

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

کد منبع

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