تسمح لك "إعلانات Google" بتحديد مبلغ ميزانية يومية لكل حملة. ومع ذلك، ستكون بعض المبادرات التسويقية مرتبطة بتكلفة ثابتة، على سبيل المثال، "أريد إنفاق 5,000 دولار أمريكي قبل بدء تخفيضات الخريف". تمنحك استراتيجية عروض الأسعار بعض التحكّم في طريقة إنفاق الميزانية اليومية، ولكن ليس في طريقة استهلاك الميزانية خلال الحملة.
على سبيل المثال، إذا أردنا إنفاق 5,000 دولار أمريكي فقط للإعلان عن تخفيضات موسم الخريف وأردنا الإعلان لمدة 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}`);
}