Anggaran yang Fleksibel - Akun Pengelola

Ikon fitur

Skrip ini memperluas Anggaran Fleksibel agar berjalan untuk beberapa akun dalam satu akun pengelola. Anggaran Fleksibel dapat menyesuaikan anggaran kampanye Anda secara dinamis setiap hari dengan skema distribusi anggaran kustom.

Skrip ini membaca spreadsheet untuk setiap akun/kampanye yang ditentukan dan anggaran yang sesuai (terkait dengan tanggal mulai dan tanggal akhir), menemukan kampanye, menghitung anggaran untuk hari ini, menetapkannya sebagai anggaran harian kampanye, dan mencatat hasilnya di spreadsheet. Ini tidak akan menyentuh kampanye yang tidak ditentukan dalam spreadsheet.

Cara kerjanya

Skrip bekerja dengan cara yang sama seperti skrip Anggaran Fleksibel akun tunggal. Satu-satunya fungsi tambahan adalah mendukung beberapa akun melalui spreadsheet yang ditentukan.

Dua kolom pertama menentukan kampanye yang akan digunakan untuk menghitung anggaran, 3 kolom berikutnya menentukan informasi anggarannya, dan yang terakhir mencatat hasil eksekusi.

ID akun harus berupa akun pengiklan, bukan akun pengelola.

Anda dapat memiliki beberapa anggaran untuk akun/kampanye yang sama, tetapi pastikan hanya memiliki satu anggaran aktif dalam satu waktu. Jika tidak, penghitungan anggaran yang baru dapat menimpa anggaran lama

Jika akun/kampanye tidak ditentukan di spreadsheet, skrip tidak akan menetapkan anggaran fleksibel untuk akun/kampanye tersebut.

Menguji strategi anggaran

Skrip ini menyertakan kode pengujian untuk menyimulasikan efek berjalan selama beberapa hari. Hal ini memberi Anda gambaran yang lebih baik tentang apa yang terjadi ketika skrip dijadwalkan untuk berjalan setiap hari selama jangka waktu tertentu.

Secara default, skrip ini menyimulasikan distribusi anggaran yang merata sebesar $500 yang dibelanjakan selama 10 hari.

Anda dapat menjalankan kode pengujian dengan memanggil testBudgetStrategy, bukan setNewBudget di metode utama:

function main() {
  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  //  setNewBudget(calculateBudgetWeighted);
}

Panggilan fungsi setNewBudget akan diberi komentar, yang menunjukkan bahwa skrip sedang menjalankan kode pengujian. Berikut adalah output dari contoh tersebut:

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

Setiap hari anggaran baru dihitung untuk memastikan anggaran dibelanjakan secara merata setiap hari. Setelah alokasi anggaran awal terlampaui, anggaran ditetapkan ke nol untuk menghentikan pembelanjaan.

Anda dapat mengubah strategi anggaran yang digunakan dengan mengubah fungsi yang digunakan, atau dengan memodifikasi fungsi itu sendiri. Skrip ini dilengkapi dengan dua strategi bawaan: calculateBudgetEvenly dan calculateBudgetWeighted; contoh sebelumnya baru saja menguji strategi sebelumnya—perbarui baris testBudgetStrategy untuk menggunakan yang terakhir:

testBudgetStrategy(calculateBudgetWeighted, 10, 500);

Klik Preview dan periksa output pencatat log. Perhatikan bahwa strategi anggaran ini mengalokasikan lebih sedikit anggaran di awal periode dan meningkatkannya selama beberapa hari ke depan.

Anda dapat menggunakan metode pengujian ini untuk menyimulasikan perubahan pada fungsi penghitungan anggaran dan mencoba pendekatan Anda sendiri dalam mendistribusikan anggaran.

Alokasi anggaran

Mari kita pelajari lebih lanjut strategi anggaran calculateBudgetWeighted:

// One calculation logic that distributes remaining budget in a weighted manner
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);
  }
}

Fungsi ini menggunakan argumen berikut:

  • costSoFar: Jumlah biaya yang terakumulasi untuk kampanye ini dari startDate hingga hari ini.
  • totalBudget: Jumlah yang akan dibelanjakan dari startDate hingga endDate.
  • daysSoFar: Berapa hari berlalu dari startDate hingga hari ini.
  • totalDays: Jumlah total hari antara tanggal startDate dan endDate.

Anda dapat menulis fungsi Anda sendiri selama menggunakan argumen ini. Dengan menggunakan nilai ini, Anda dapat membandingkan jumlah uang yang telah dibelanjakan sejauh ini dengan jumlah yang dibelanjakan secara keseluruhan dan menentukan posisi Anda saat ini dalam linimasa untuk keseluruhan anggaran.

Secara khusus, strategi anggaran ini mencari tahu jumlah anggaran yang tersisa (totalBudget - costSoFar) dan membaginya dengan dua kali jumlah hari yang tersisa. Hal ini mempertimbangkan distribusi anggaran menjelang akhir kampanye. Dengan menggunakan biaya sejak startDate, biaya ini juga memperhitungkan "hari lambat" saat Anda tidak membelanjakan seluruh anggaran yang ditetapkan.

Penganggaran dalam produksi

Setelah puas dengan strategi anggaran, Anda harus melakukan beberapa perubahan sebelum dapat menjadwalkan skrip ini untuk berjalan setiap hari.

Pertama, perbarui spreadsheet untuk menentukan akun, kampanye, anggaran, tanggal mulai, tanggal akhir—satu baris untuk setiap anggaran kampanye.

  • ID Akun: ID akun (dengan format xxx-xxx-xxxx) kampanye untuk menerapkan strategi anggaran.
  • Nama Kampanye: Nama kampanye tempat strategi anggaran akan diterapkan.
  • Tanggal Mulai: Tanggal mulai strategi anggaran. Tanggal ini harus berupa tanggal saat ini atau hari yang sudah lewat.
  • Tanggal Akhir: Hari terakhir Anda ingin beriklan dengan anggaran ini.
  • Total Anggaran: Total jumlah yang ingin Anda belanjakan. Nilai ini menggunakan mata uang akun dan dapat dilampaui bergantung pada kapan skrip dijadwalkan untuk dijalankan.

Selanjutnya, nonaktifkan pengujian dan aktifkan logika untuk benar-benar mengubah anggaran:

function main() {
  //  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  setNewBudget(calculateBudgetWeighted);
}

Hasil untuk setiap kampanye dicatat di kolom Hasil Eksekusi.

Penjadwalan

Jadwalkan skrip ini untuk berjalan setiap hari, pada saat atau segera setelah tengah malam di zona waktu lokal guna mengalokasikan anggaran untuk hari yang akan datang secepat mungkin. Namun, perhatikan bahwa data laporan yang diambil seperti biaya dapat tertunda selama sekitar 3 jam, sehingga parameter costSoFar mungkin merujuk pada total kemarin untuk skrip yang dijadwalkan berjalan setelah tengah malam.

Penyiapan

  • Klik tombol di bawah untuk membuat skrip di akun Google Ads Anda.

    Menginstal template skrip

  • Klik tombol di bawah ini untuk membuat salinan {i>spreadsheet<i} {i>template<i}.

    Menyalin spreadsheet template

  • Mengupdate spreadsheet_url dalam skrip Anda.

  • Jadwalkan skrip untuk dijalankan Harian.

Kode sumber

// 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 MCC Flexible Budgets
 *
 * @overview The MCC Flexible Budgets script dynamically adjusts campaign budget
 *     daily for accounts under an MCC account with a custom budget distribution
 *     scheme. See
 *     https://developers.google.com/google-ads/scripts/docs/solutions/manager-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.4
 *   - Add support for video and shopping campaigns.
 * - version 1.0.3
 *   - Added validation for external spreadsheet setup.
 * - version 1.0.2
 *   - Fix a minor bug in variable naming.
 *   - 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 = {
  // URL of the default spreadsheet template. This should be a copy of
  // https://docs.google.com/spreadsheets/d/17wocOgrLeRWF1Qi_BjEigCG0qVMebFHrbUS-Vk_kpLg/copy
  // Make sure the sheet is owned by or shared with same Google user executing the script
  'spreadsheet_url': 'YOUR_SPREADSHEET_URL',

  'advanced_options': {
    // Please fix the following variables if you need to reformat the
    // spreadsheet
    // column numbers of each config column. Column A in your spreadsheet has
    // column number of 1, B has number of 2, etc.
    'column': {
      'accountId': 2,
      'campaignName': 3,
      'startDate': 4,
      'endDate': 5,
      'totalBudget': 6,
      'results': 7
    },

    // Actual config (without header and margin) starts from this row
    'config_start_row': 5
  }
};

const SPREADSHEET_URL = CONFIG.spreadsheet_url;
const COLUMN = CONFIG.advanced_options.column;
const CONFIG_START_ROW = CONFIG.advanced_options.config_start_row;

function main() {
  // Uncomment the following function to test your budget strategy function
  // testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  setNewBudget(calculateBudgetWeighted);
}

// Core logic for calculating and setting campaign daily budget
function setNewBudget(budgetFunc) {
  console.log(`Using spreadsheet - ${SPREADSHEET_URL}.`);
  const spreadsheet = validateAndGetSpreadsheet(SPREADSHEET_URL);
  spreadsheet.setSpreadsheetTimeZone(AdsApp.currentAccount().getTimeZone());
  const sheet = spreadsheet.getSheets()[0];

  const endRow = sheet.getLastRow();

  const mccAccount = AdsApp.currentAccount();
  sheet.getRange(2, 6, 1, 2).setValue(mccAccount.getCustomerId());

  const today = new Date();

  for (let i = CONFIG_START_ROW; i <= endRow; i++) {
    console.log(`Processing row ${i}`);

    const accountId = sheet.getRange(i, COLUMN.accountId).getValue();
    const campaignName = sheet.getRange(i, COLUMN.campaignName).getValue();
    const startDate = new Date(sheet.getRange(i, COLUMN.startDate).getValue());
    const endDate = new Date(sheet.getRange(i, COLUMN.endDate).getValue());
    const totalBudget = sheet.getRange(i, COLUMN.totalBudget).getValue();
    const resultCell = sheet.getRange(i, COLUMN.results);

    const accountIter = AdsManagerApp.accounts().withIds([accountId]).get();
    if (!accountIter.hasNext()) {
      resultCell.setValue('Unknown account');
      continue;
    }
    const account = accountIter.next();
    AdsManagerApp.select(account);

    const campaign = getCampaign(campaignName);
    if (!campaign) {
      resultCell.setValue('Unknown campaign');
      continue;
    }

    if (today < startDate) {
      resultCell.setValue('Budget not started yet');
      continue;
    }
    if (today > endDate) {
      resultCell.setValue('Budget already finished');
      continue;
    }

    const costSoFar = campaign
                          .getStatsFor(
                              getDateStringInTimeZone('yyyyMMdd', startDate),
                              getDateStringInTimeZone('yyyyMMdd', endDate))
                          .getCost();
    const daysSoFar = datediff(startDate, today);
    const totalDays = datediff(startDate, endDate);
    const newBudget = budgetFunc(costSoFar, totalBudget, daysSoFar, totalDays);
    campaign.getBudget().setAmount(newBudget);
    console.log(
        `AccountId=${accountId}, CampaignName=${campaignName}, ` +
        `StartDate=${startDate}, EndDate=${endDate}, ` +
        `CostSoFar=${costSoFar}, DaysSoFar=${daysSoFar}, ` +
        `TotalDays=${totalDays}, NewBudget=${newBudget}'`);
    resultCell.setValue(`Set today's budget to ${newBudget}`);
  }

  // update "Last execution" timestamp
  sheet.getRange(1, 3).setValue(today);
  AdsManagerApp.select(mccAccount);
}

// One calculation logic that distributes remaining budget evenly
function calculateBudgetEvenly(costSoFar, totalBudget, daysSoFar, totalDays) {
  const daysRemaining = totalDays - daysSoFar;
  const budgetRemaining = totalBudget - costSoFar;
  if (daysRemaining <= 0) {
    return budgetRemaining;
  } else {
    return budgetRemaining / daysRemaining;
  }
}

// One calculation logic that distributes remaining budget in a weighted manner
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);
  }
}

// Test function to verify budget calculation logic
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;
  }
}

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

// Produces a formatted string representing a given date in a given time zone.
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();
    }
  }
  return null;
}

/**
 * Validates the provided spreadsheet URL to make sure that it's set up
 * properly. Throws a descriptive error message if validation fails.
 *
 * @param {string} spreadsheeturl The URL of the spreadsheet to open.
 * @return {Spreadsheet} The spreadsheet object itself, fetched from the URL.
 * @throws {Error} If the spreadsheet URL hasn't been set
 */
function validateAndGetSpreadsheet(spreadsheeturl) {
  if (spreadsheeturl == 'YOUR_SPREADSHEET_URL') {
    throw new Error(
        'Please specify a valid Spreadsheet URL. You can find' +
        ' a link to a template in the associated guide for this script.');
  }
  return SpreadsheetApp.openByUrl(spreadsheeturl);
}