תקציבים גמישים – חשבון יחיד

לוחצים על סמל מפתח הברגים

ב-Google Ads אפשר להגדיר סכום תקציב יומי לכל קמפיין. עם זאת, לחלק מהיוזמות השיווקיות יש עלות קבועה שמשויכת אליהן. לדוגמה: "אני רוצה להוציא 5,000 $עד למבצע סוף הקיץ שלנו". שיטת הבידינג מאפשרת לכם לשלוט במידה מסוימת באופן שבו התקציב היומי מנוצל, אבל לא מאפשרת לכם לשלוט באופן שבו התקציב מנוצל במהלך הקמפיין.

לדוגמה, אם אנחנו רוצים להוציא רק 5,000 $על פרסום מבצע סתיו למשך 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);

לוחצים על תצוגה מקדימה ובודקים את הפלט של כלי הרישום. שימו לב ששיטת התקציב הזו מקצה פחות תקציב בתחילת התקופה ויותר תקציב במהלך הימים האחרונים.

אתם יכולים להשתמש בשיטת הבדיקה הזו כדי לדמות שינויים בפונקציות של חישוב התקציב, ולנסות גישה משלכם לחלוקת התקציב.

הקצאת תקציב

שיטת הבידינג לפי תקציב 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) ומחלקת אותו במספר הימים שנותרו כפול 2. המשמעות היא שהתקציב ינוצל יותר לקראת סוף הקמפיין. השימוש בעלות מאז 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.

    התקנת תבנית הסקריפט

  • שומרים את הסקריפט ולוחצים על הלחצן תצוגה מקדימה. הסקריפט הזה (כברירת מחדל) מדמה שיטת בידינג לפי תקציב עם 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}`);
}