Flexible Budgets – Verwaltungskonto

Dieses Skript erweitert flexible Budgets so, dass es für mehrere Konten in einem Verwaltungskonto ausgeführt werden kann. Mit flexiblen Budgets kann Ihr Kampagnenbudget über ein benutzerdefiniertes Verteilungsschema täglich dynamisch angepasst werden.

Das Skript liest eine Tabelle für jedes angegebene Konto und jede angegebene Kampagne und das entsprechende Budget, das mit Start- und Enddatum verknüpft ist, sucht die Kampagne, berechnet das Budget für den aktuellen Tag, legt es als Tagesbudget der Kampagne fest und zeichnet das Ergebnis in der Tabelle auf. Kampagnen, die nicht in der Tabelle angegeben sind, bleiben erhalten.

Funktionsweise

Das Skript funktioniert auf die gleiche Art und Weise wie das Skript "Flexible Budgets für einzelne Konten". Die einzige zusätzliche Funktion besteht in der Unterstützung mehrerer Konten über die angegebene Tabelle.

Die ersten beiden Spalten geben die Kampagne an, für die ein Budget berechnet werden soll, die nächsten drei Spalten enthalten Budgetinformationen und die letzte zeichnet das Ausführungsergebnis auf.

Die Konto-ID muss ein Werbetreibendenkonto sein, kein Verwaltungskonto.

Sie können mehrere Budgets für dasselbe Konto oder dieselbe Kampagne haben. Achten Sie aber darauf, dass jeweils nur ein aktives Budget vorhanden ist. Andernfalls könnte eine neuere Budgetberechnung ein älteres überschreiben.

Ist in der Tabelle kein Konto oder keine Kampagne angegeben, legt das Skript kein flexibles Budget dafür fest.

Budgetstrategien testen

Das Skript enthält Testcode, der die Auswirkungen des Skripts über mehrere Tage simuliert. So erhalten Sie eine bessere Vorstellung davon, was passiert, wenn das Skript über einen bestimmten Zeitraum täglich ausgeführt wird.

Standardmäßig simuliert das Script eine gleichmäßige Budgetverteilung von 500 $, die über 10 Tage ausgegeben wird.

Sie können den Testcode ausführen, indem Sie in der Hauptmethode testBudgetStrategy anstelle von setNewBudget aufrufen:

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

Der Funktionsaufruf setNewBudget ist auskommentiert, um darauf hinzuweisen, dass das Skript Testcode ausführt. Die Ausgabe aus diesem Beispiel sieht wie folgt aus:

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

Jeden Tag wird ein neues Budget berechnet, damit es jeden Tag gleichmäßig ausgegeben wird. Nach Überschreiten des anfänglichen Budgetkontingents wird das Budget auf null gesetzt, sodass keine Ausgaben mehr entstehen.

Sie können die verwendete Budgetstrategie ändern, indem Sie die verwendete Funktion oder die Funktion selbst anpassen. Das Skript enthält zwei vorkonfigurierte Strategien: calculateBudgetEvenly und calculateBudgetWeighted. Im vorherigen Beispiel wurde die erste Strategie getestet. Ändern Sie die Zeile testBudgetStrategy, um die zweite Strategie zu verwenden:

testBudgetStrategy(calculateBudgetWeighted, 10, 500);

Klicken Sie auf Vorschau und prüfen Sie die Protokollausgabe. Dabei wird zu Beginn des Zeitraums weniger Budget zugewiesen und für die nächsten Tage erhöht.

Nutzen Sie diese Testmethode, um Änderungen an den Budgetberechnungsfunktionen zu simulieren und einen eigenen Ansatz zur Verteilung eines Budgets zu finden.

Budgetzuweisung

Sehen wir uns die Budgetstrategie „calculateBudgetWeighted“ genauer an:

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

Diese Funktion akzeptiert folgende Argumente:

• costSoFar: Die Kosten für diese Kampagne vom startDate bis heute.
• totalBudget: Dies ist der Betrag, den Sie zwischen startDate und endDate ausgeben möchten.
• daysSoFar: Gibt an, wie viele Tage von startDate bis heute bereits vergangen sind.
• totalDays: Gesamtzahl der Tage zwischen startDate und endDate.

Sie können auch eine eigene Funktion schreiben, die ebenfalls diese Argumente akzeptiert. Mit diesen Werten vergleichen Sie, wie viel Sie bereits ausgegeben haben und wie viel Sie insgesamt ausgeben werden. Außerdem ermitteln Sie, an welchem Punkt des Zeitraums für das gesamte Budget Sie sich gerade befinden.

Mit dieser Budgetstrategie ermitteln Sie insbesondere, wie viel Budget übrig bleibt (totalBudget – costSoFar) und geteilt durch die doppelte Anzahl der verbleibenden Tage. Dadurch wird die Budgetverteilung gegen Ende der Kampagne gewogen. Indem Sie die Kosten seit startDate verwenden, werden auch Tage mit wenig Aktivität berücksichtigt, an denen Sie nicht das gesamte von Ihnen festgelegte Budget ausgegeben haben.

Budgetierung in der Produktion

Wenn Sie mit Ihrer Budgetstrategie zufrieden sind, müssen Sie ein paar Änderungen vornehmen, bevor Sie die tägliche Ausführung des Skripts planen können.

Aktualisieren Sie zuerst die Tabelle, um das Konto, die Kampagne, das Budget, das Startdatum und das Enddatum anzugeben. Verwenden Sie für jedes Kampagnenbudget eine Zeile.

• Konto-ID: Konto-ID (im Format xxx-xxx-xxxx) der Kampagne, auf die die Budgetstrategie angewendet werden soll.
• Kampagnenname: Der Name der Kampagne, auf die die Budgetstrategie angewendet wird.
• Startdatum: Das Startdatum der Budgetstrategie. Dies sollte das aktuelle Datum oder ein Tag in der Vergangenheit sein.
• Enddatum: Der letzte Tag, an dem Sie mit diesem Budget werben möchten.
• Gesamtbudget: Der Gesamtbetrag, den Sie ausgeben möchten. Dieser Wert ist in der Kontowährung angegeben und kann abhängig davon, für welche Zeit die Skriptausführung geplant ist, überschritten werden.

Deaktivieren Sie nun den Test und aktivieren Sie den Code, der tatsächlich das Budget ändert:

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

Das Ergebnis wird für jede Kampagne in der Spalte Ausführungsergebnis aufgezeichnet.

Wird geplant

Planen Sie das Skript täglich um oder kurz nach Mitternacht in Ihrer Zeitzone, um möglichst viel des Tagesbudgets für den kommenden Tag zuzuweisen. Hinweis: abgerufene Berichtsdaten wie Kosten können sich jedoch um etwa drei Stunden verzögern. Der Parameter costSoFar kann sich also auf die Gesamtsumme des Vortags für ein Script beziehen, das nach Mitternacht ausgeführt werden soll.

Einrichtung

• Klicken Sie auf die Schaltfläche unten, um das Skript in Ihrem Google Ads-Konto zu erstellen.

  Skriptvorlage installieren

• Klicken Sie auf die Schaltfläche unten, um eine Kopie der Tabellenvorlage zu erstellen.

  Tabellenvorlage kopieren

• Aktualisieren Sie spreadsheet_url im Script.

• Planen Sie das Skript für eine tägliche Ausführung.

Quellcode

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