Questa pagina è stata tradotta dall'API Cloud Translation.

Budget flessibili - Singolo account

Seleziona l'icona degli strumenti

Google Ads ti consente di impostare un budget giornaliero per ogni campagna. Tuttavia, alcune iniziative di marketing avranno un costo fisso; ad esempio, "Voglio spendere 5000 € per i nostri saldi autunnali". La strategia di offerta ti offre un certo controllo su come viene speso il budget giornaliero, ma non su come viene utilizzato il budget durante la campagna.

Ad esempio, se vogliamo spendere solo 5000 € per pubblicizzare i nostri saldi autunnali e vogliamo fare pubblicità per 10 giorni, possiamo impostare un budget giornaliero di 500 € per esaurire l'intero budget. Tuttavia, si presuppone che spenderemo l'intero importo ogni giorno E che desideriamo spenderlo in modo uniforme. Non è possibile comunicare a Google Ads che vuoi spendere la maggior parte del budget nel corso degli ultimi giorni.

Questo script regolerà dinamicamente il budget della campagna ogni giorno con uno schema di distribuzione del budget personalizzato.

Come funziona

Test delle strategie di budget

Lo script include del codice di test per simulare gli effetti dell'esecuzione per più giorni. In questo modo puoi avere un'idea migliore di cosa potrebbe accadere quando lo script viene eseguito ogni giorno in un determinato periodo di tempo.

Per impostazione predefinita, questo script simula una distribuzione del budget uniforme di 500 $spesi in 10 giorni.

function main() {
  testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  // setNewBudget(calculateBudgetEvenly, CAMPAIGN_NAME, TOTAL_BUDGET, START_DATE, END_DATE);
}

La chiamata di funzione setNewBudget è commentata, il che significa che verrà eseguito solo il codice di test. Ecco l'output dell'esempio:

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

Ogni giorno lo script calcola un nuovo budget per garantire che la spesa del budget venga distribuita in modo uniforme. Quando viene raggiunto il limite di budget assegnato, il budget viene impostato su zero, interrompendo la spesa.

Puoi cambiare la strategia di budget utilizzata cambiando la funzione utilizzata o modificando la funzione stessa. Lo script è dotato di due strategie predefinite: calculateBudgetEvenly e calculateBudgetWeighted. Per impostare una strategia di budget di test ponderato, modifica testBudgetStrategy nel seguente modo:

testBudgetStrategy(calculateBudgetWeighted, 10, 500);

Fai clic su Anteprima e controlla l'output del logger. Tieni presente che questa strategia di budget assegna meno budget all'inizio del periodo e di più negli ultimi giorni.

Puoi utilizzare questo metodo di test per simulare modifiche alle funzioni di calcolo del budget e provare il tuo approccio alla distribuzione del budget.

Allocare un budget

La strategia di budget calculateBudgetWeighted viene implementata tramite la seguente funzione:

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

Questa funzione accetta i seguenti argomenti:

costSoFar: Costo maturato dalla campagna da START_DATE a oggi.
totalBudget: Spesa allocata da START_DATE a END_DATE.
daysSoFar: Giorni trascorsi dal giorno START_DATE a oggi.
totalDays: Numero totale di giorni compresi tra START_DATE e END_DATE.

Puoi scrivere una tua funzione purché siano necessari questi argomenti. Utilizzando questi valori, puoi confrontare l'importo speso finora con la spesa complessiva e determinare dove ti trovi attualmente all'interno del periodo di tempo per l'intero budget.

In particolare, questa strategia di budget determina il budget residuo (totalBudget - costSoFar) e lo divide per il doppio del numero di giorni rimanenti. Questo valore pondera la distribuzione del budget verso la fine della campagna. Utilizzando il costo dal giorno START_DATE, vengono presi in considerazione anche le "giornate lente" in cui il budget impostato non è stato speso completamente.

Definizione del budget reale

Se la tua strategia di budget ti soddisfa, devi apportare alcune modifiche prima di pianificare l'esecuzione giornaliera di questo script.

Per prima cosa, aggiorna le costanti nella parte superiore del file:

START_DATE: impostala all'inizio della tua strategia di budget. Deve essere la data corrente o un giorno nel passato.
END_DATE: imposta l'opzione sull'ultimo giorno in cui vuoi fare pubblicità con questo budget.
TOTAL_BUDGET: l'importo totale che stai cercando di spendere. Questo valore è nella valuta dell'account e potrebbe essere superato a seconda di quando è pianificata l'esecuzione dello script.
CAMPAIGN_NAME: il nome della campagna a cui applicare la strategia di budget.

Successivamente, disattiva il test e attiva la logica in modo che modifichi effettivamente il budget:

function main() {
  // testBudgetStrategy(calculateBudgetEvenly, 10, 500);
  setNewBudget(calculateBudgetWeighted, CAMPAIGN_NAME, TOTAL_BUDGET, START_DATE, END_DATE);
}

Programmazione

Pianifica questo script in modo che venga eseguito ogni giorno, a mezzanotte o poco dopo nel fuso orario locale, in modo da gestire il più possibile il budget del giorno successivo. Tieni presente, tuttavia, che i dati dei report recuperati, come il costo, potrebbero subire un ritardo di circa tre ore, quindi il parametro costSoFar potrebbe fare riferimento al totale di ieri per uno script pianificato per l'esecuzione dopo mezzanotte.

Configurazione

Fai clic sul pulsante di seguito per creare lo script nel tuo account Google Ads.

Installare il modello di script
Salva lo script e fai clic sul pulsante Anteprima. Questo script (per impostazione predefinita) simula una strategia di budget con 500 $in 10 giorni. L'output del logger riflette il giorno della simulazione, il budget allocato per quel giorno e l'importo totale speso fino a oggi.

Codice sorgente

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