Budgets flexibles – Un seul compte

Icône Outils

Google Ads vous permet de définir un budget quotidien pour chaque campagne. Cependant, certains projets marketing sont associés à un coût fixe (par exemple, "Je souhaite dépenser 5 000 € à l'approche des soldes d'automne"). La stratégie d'enchères vous permet de contrôler la façon dont le budget quotidien est dépensé, mais pas de la manière dont il est utilisé au cours de la campagne.

Par exemple, si vous souhaitez ne dépenser que 5 000 € pour promouvoir vos soldes d'automne et diffuser votre annonce pendant 10 jours, vous pouvez définir un budget quotidien de 500 € afin d'épuiser la totalité de votre budget. Toutefois, cela suppose que nous dépenserons la totalité de la somme chaque jour ET que nous souhaitons la dépenser de manière égale. Vous ne pouvez pas indiquer à Google Ads que vous souhaitez dépenser l'essentiel du budget au cours des derniers jours.

Ce script ajuste quotidiennement le budget de votre campagne de manière dynamique à l'aide d'un programme de répartition budgétaire personnalisé.

Comment ça marche ?

Tester des stratégies budgétaires

Le script inclut du code de test pour simuler les effets d'une exécution sur plusieurs jours. Cela vous donne une meilleure idée de ce qui peut se produire lorsque le script est programmé pour s'exécuter quotidiennement pendant une période donnée.

Par défaut, ce script simule une répartition budgétaire égale de 500 $dépensés sur 10 jours.

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

L'appel de fonction setNewBudget est commenté, ce qui indique qu'il n'exécutera que le code de test. Voici le résultat de l'exemple :

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

Chaque jour, le script calcule un nouveau budget pour s'assurer que les dépenses budgétaires sont réparties uniformément. Lorsque la limite de budget allouée est atteinte, le budget est défini sur zéro, ce qui arrête les dépenses.

Vous pouvez modifier la stratégie budgétaire soit en changeant de fonction, soit en modifiant la fonction elle-même. Le script est fourni avec deux stratégies prédéfinies : calculateBudgetEvenly et calculateBudgetWeighted. Pour définir une stratégie de budget de test pondéré, modifiez testBudgetStrategy comme suit:

testBudgetStrategy(calculateBudgetWeighted, 10, 500);

Cliquez sur Preview (Aperçu) et vérifiez ce qui est consigné dans le journal de résultat. Notez que cette stratégie budgétaire attribue moins de budget au début de la période et davantage au cours des derniers jours.

Vous pouvez utiliser cette méthode de test pour simuler les modifications apportées aux fonctions de calcul du budget et tester votre propre approche de répartition du budget.

Attribuer un budget

La stratégie budgétaire calculateBudgetWeighted est implémentée via la fonction suivante:

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

Cette fonction utilise les arguments suivants:

costSoFar
Coût cumulé de la campagne du START_DATE à aujourd'hui.
totalBudget
Dépenses de START_DATE allouées au END_DATE.
daysSoFar
Jours écoulés entre START_DATE et aujourd'hui.
totalDays
Nombre total de jours entre START_DATE et END_DATE.

Vous avez la possibilité d'écrire votre propre fonction à condition d'inclure ces arguments. À l'aide de ces valeurs, vous pouvez comparer le montant dépensé jusqu'à présent et le montant à dépenser globalement, et déterminer où vous en êtes dans le calendrier pour l'ensemble du budget.

Plus précisément, cette stratégie budgétaire calcule le montant restant du budget (totalBudget - costSoFar) et le divise par deux fois le nombre de jours restants. Ce calcul permet de pondérer la répartition du budget jusqu'à la fin de la campagne. En utilisant le coût depuis START_DATE, il prend également en compte les "jours de ralentissement" où le budget défini n'est pas entièrement dépensé.

Gérer un budget en situation réelle

Une fois que vous êtes satisfait de votre stratégie budgétaire, vous devez apporter quelques modifications avant de planifier l'exécution quotidienne de ce script.

Dans un premier temps, mettez à jour les constantes dans la partie supérieure du fichier :

  • START_DATE: indiquez le début de votre stratégie budgétaire. Il doit s'agir de la date du jour ou d'une date antérieure.
  • END_DATE: indiquez la date du dernier jour pendant lequel vous souhaitez diffuser des annonces avec ce budget.
  • TOTAL_BUDGET: montant total que vous voulez dépenser. Il se peut que cette valeur, indiquée dans la devise du compte, soit dépassée selon la date d'exécution planifiée du script.
  • CAMPAIGN_NAME: nom de la campagne à laquelle appliquer la stratégie budgétaire.

Ensuite, désactivez le test et activez la logique pour modifier le budget en situation réelle :

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

Planification

Planifiez l'exécution de ce script quotidiennement à minuit ou juste après minuit dans le fuseau horaire local, afin de gérer autant que possible votre budget du lendemain. Notez toutefois que les données de rapport récupérées, telles que le coût, peuvent être retardées d'environ trois heures. Par conséquent, le paramètre costSoFar peut faire référence au total de la veille pour un script dont l'exécution est planifiée après minuit.

Préparation

  • Cliquez sur le bouton ci-dessous pour créer le script dans votre compte Google Ads.

    Installer le modèle de script

  • Enregistrez le script et cliquez sur le bouton Preview (Aperçu). Ce script (par défaut) simule une stratégie budgétaire de 500 $sur 10 jours. La sortie de l'enregistreur correspond au jour simulé, au budget qui lui est alloué et au montant total dépensé à ce jour.

Code source

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