الميزانيات المرنة - حساب واحد

رمز الأدوات

تتيح لك "إعلانات Google" تحديد مبلغ ميزانية يومية لكل حملة. ومع ذلك، قد لا تكون للمبادرات التسويقية تكلفة ثابتة مرتبطة بها؛ على سبيل المثال، "أريد إنفاق 5000 دولار أمريكي (أو ما يعادله بالعملة المحلية) قبل بدء تخفيضات الخريف". تمنح استراتيجية عروض الأسعار يتحكمون في كيفية إنفاق الميزانية اليومية، لكن لا يتحكمون في كيفية يتم استهلاك الميزانية أثناء الحملة.

على سبيل المثال، إذا أردنا إنفاق 5000 دولار أمريكي فقط للإعلان عن تخفيضات الخريف تريد الإعلان لمدة 10 أيام، يمكننا تعيين ميزانية يومية قدرها 500 دولار لاستخدام الميزانية بأكملها. ومع ذلك، هذا يفترض أننا سننفق المبلغ بأكمله كل يوم ونريد إنفاقه بالتساوي. لا يمكن إعلام "إعلانات Google" بأنّ تريد إنفاق الجزء الأكبر من ميزانيتك خلال الأيام القليلة الماضية.

سيُعدّل هذا النص البرمجي ميزانية حملتك يوميًا بشكل ديناميكي من خلال نظام توزيع الميزانية.

آلية العمل

اختبار استراتيجيات الميزانية

يتضمن النص البرمجي بعض رموز الاختبار لمحاكاة تأثيرات التشغيل في عدة أيام. يمنحك هذا فكرة أفضل عما قد يحدث عندما يتضمن النص يوميًا على مدى فترة زمنية.

يحاكي هذا النص البرمجي تلقائيًا توزيع ميزانية متساوية بمبلغ 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) وتقسمه على ضعف عدد الأيام المتبقية. يوازن هذا في توزيع الميزانية نحو نهاية . باستخدام التكلفة منذ 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".

    تثبيت نموذج النص البرمجي

  • احفظ النص البرمجي وانقر على الزر معاينة. هذا النص (بواسطة بشكلٍ تلقائي) استراتيجية ميزانية بمبلغ 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}`);
}