Esnek Bütçeler - Yönetici Hesabı

Bu komut dosyası, Esnek Bütçeler'i tek bir yönetici hesabı altındaki birden çok hesap için çalışacak şekilde genişletir. Esnek Bütçeler, özel bir bütçe dağıtım şemasıyla kampanya bütçenizi günlük olarak dinamik bir şekilde ayarlayabilir.

Komut dosyası, belirtilen her hesap/kampanya ve karşılık gelen bütçe (başlangıç tarihi ve bitiş tarihiyle ilişkilendirilen) için bir e-tablo okur, kampanyayı bulur, geçerli günün bütçesini hesaplar, kampanyanın günlük bütçesi olarak belirler ve sonucu e-tabloya kaydeder. E-tabloda belirtilmemiş kampanyalara dokunmaz.

İşleyiş şekli

Komut dosyası, tek hesabın Esnek Bütçe komut dosyasıyla aynı şekilde çalışır. Tek ek işlev, belirtilen e-tablo üzerinden birden fazla hesabı desteklemesidir.

İlk 2 sütun bütçesi hesaplanacak kampanyayı, sonraki 3 sütun bütçe bilgilerini ve son 2 sütun yürütme sonucunu belirtir.

Hesap kimliği bir yönetici hesabı değil, reklamveren hesabı olmalıdır.

Aynı hesap/kampanya için birden fazla bütçeniz olabilir, ancak aynı anda yalnızca tek bir etkin bütçenizin olduğundan emin olun. Aksi takdirde yeni bir bütçe hesaplaması, eski bir bütçenin üzerine yazabilir.

E-tabloda bir hesap/kampanya belirtilmemişse, komut dosyası bunun için esnek bütçe ayarlamaz.

Bütçe stratejilerini test etme

Komut dosyası, birkaç gün çalışmanın etkilerini simüle etmek için test amaçlı kod içerir. Bu, komut dosyası belirli bir süre boyunca günlük olarak çalışacak şekilde planlandığında ne olacağı konusunda daha iyi bir fikir edinmenizi sağlar.

Varsayılan olarak bu komut dosyası, 10 gün boyunca harcanan 500 ABD doları değerinde eşit bir bütçe dağılımını simüle eder.

Ana yöntemde setNewBudget yerine testBudgetStrategy yöntemini çağırarak test kodunu çalıştırabilirsiniz:

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

setNewBudget işlev çağrısı, komut dosyasının test kodunu çalıştırdığını belirten yorumla belirtilmiş. Aşağıda, örnekteki çıkışı görebilirsiniz:

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

Bütçenin her gün eşit sıklıkta harcanmasını sağlamak için her gün yeni bir bütçe hesaplanır. Başlangıçtaki bütçe servis birimi sınırı aşıldığında, harcamayı durdurmak için bütçe sıfıra ayarlanır.

Kullanılan bütçe stratejisini, hangi işlevin kullanılacağını değiştirerek veya işlevin kendisini değiştirerek değiştirebilirsiniz. Komut dosyası, önceden oluşturulmuş iki stratejiyle gelir: calculateBudgetEvenly ve calculateBudgetWeighted. Önceki örnek, ilkini test etti. testBudgetStrategy satırını, ikincisini kullanacak şekilde güncelleyin:

testBudgetStrategy(calculateBudgetWeighted, 10, 500);

Preview (Önizleme) seçeneğini tıklayın ve logger çıktısını kontrol edin. Bu bütçe stratejisinin dönemin başlarında daha az bütçe ayırdığına ve sonraki birkaç gün boyunca bu bütçeyi artırdığına dikkat edin.

Bu test yöntemini kullanarak bütçe hesaplama işlevlerindeki değişiklikleri simüle edebilir ve bütçeyi dağıtırken kendi yaklaşımınızı deneyebilirsiniz.

Bütçe ayırma

calculateBudgetWeighted bütçe stratejisini daha yakından inceleyelim:

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

Bu işlev aşağıdaki bağımsız değişkenleri alır:

• costSoFar: Bu kampanyanın startDate tarihinden bugüne kadar tahakkuk eden maliyeti nedir?
• totalBudget: startDate-endDate tarihleri arasında yapılacak harcama tutarı.
• daysSoFar: startDate ile bugün arasında geçen gün sayısı.
• totalDays: startDate ile endDate arasındaki toplam gün sayısı.

Bu bağımsız değişkenleri aldığı sürece kendi işlevinizi yazabilirsiniz. Bu değerleri kullanarak, şimdiye kadar ne kadar para harcadığınızı, toplamda ne kadar harcayacağınızla karşılaştırabilir ve tüm bütçe için zaman çizelgesi dahilinde şu anda nerede olduğunuzu belirleyebilirsiniz.

Bu bütçe stratejisi özellikle ne kadar bütçe kaldığını (totalBudget - costSoFar) hesaplar ve bunu kalan gün sayısının iki katına böler. Bu metrik, kampanyanın sonuna doğru bütçe dağılımını ağırlıklandırır. startDate tarihinden itibaren maliyet kullanıldığında, belirlediğiniz bütçenin tamamını harcamadığınız "yavaş günler" de dikkate alınır.

Üretimde bütçe oluşturma

Bütçe stratejinizden memnun kaldığınızda, bu komut dosyasını günlük olarak çalışacak şekilde programlamadan önce birkaç değişiklik yapmanız gerekir.

Öncelikle hesap, kampanya, bütçe, başlangıç tarihi, bitiş tarihi (her kampanya bütçesi için bir satır) belirtmek üzere e-tabloyu güncelleyin.

• Hesap Kimliği: Bütçe stratejisinin uygulanacağı kampanyanın hesap kimliği (xxx-xxx-xxxx biçiminde).
• Kampanya Adı: Bütçe stratejisinin uygulanacağı kampanyanın adı.
• Başlangıç Tarihi: Bütçe stratejinizin başlangıç tarihi. Geçerli tarih veya geçmişteki bir gün olmalıdır.
• Bitiş Tarihi: Bu bütçeyle reklam vermek istediğiniz son gün.
• Toplam Bütçe: Harcamaya çalıştığınız toplam tutar. Bu değer hesabın para birimindedir ve komut dosyasının çalıştırılmak üzere planlandığı zamana bağlı olarak aşılabilir.

Daha sonra testi devre dışı bırakın ve bütçeyi gerçekten değiştirme mantığını etkinleştirin:

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

Her kampanyanın sonucu Yürütme Sonucu sütununa kaydedilir.

Scheduling (Zaman planlama)

Bir sonraki günün bütçesini mümkün olduğunca yönlendirmek için bu komut dosyasını yerel saat diliminde her gün, gece yarısından kısa bir süre sonra çalışacak şekilde planlayın. Bununla birlikte, maliyet gibi rapor verilerinin alınmasında yaklaşık 3 saat gecikebileceğini unutmayın. Bu nedenle, costSoFar parametresi, gece yarısından sonra çalışması planlanan bir komut dosyası için dünün toplamını referans alıyor olabilir.

Kurulum

• Komut dosyasını Google Ads hesabınızda oluşturmak için aşağıdaki düğmeyi tıklayın.

  Komut dosyası şablonunu yükleme

• Şablon e-tablosunun kopyasını oluşturmak için aşağıdaki düğmeyi tıklayın.

  Şablon e-tablosunu kopyalama

• Komut dosyanızdaki spreadsheet_url öğesini güncelleyin.

• Komut dosyasını Günlük çalışacak şekilde planlayın.

Kaynak kodu

// 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 [[e-mail]]
 *
 * @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);
}