Google Ads Scripts : automatiser la gestion de ses campagnes

Découvrir et utiliser les scripts Google Ads pour automatiser la gestion de ses campagnes : exemples concrets de scripts utiles, installation pas à pas, bonnes pratiques et limites de l'automatisation.

Rédigé par
Alexandre PAULRédacteur et éditeur de Kenoby
Publié le
mis à jour le
Lecture
8 min
Sommaire
  1. Qu'est-ce qu'un script Google Ads ?
  2. Installer un script : procédure pas à pas
  3. 5 scripts utiles à installer
  4. Bibliothèques de scripts gratuits
  5. Les limites des scripts Google Ads
  6. FAQ : Scripts Google Ads

En bref

Les scripts Google Ads sont des programmes JavaScript exécutés dans votre compte pour automatiser des tâches répétitives : mettre en veille des mots-clés, ajuster des enchères, exporter des rapports vers Google Sheets ou surveiller les budgets. On les crée dans Outils > Actions groupées > Scripts, on les teste en aperçu, puis on les planifie, au plus toutes les heures.

Qu'est-ce qu'un script Google Ads ?

Les scripts Google Ads (anciennement AdWords Scripts) sont du code JavaScript exécuté directement depuis l'interface Google Ads. Ils accèdent aux données de votre compte (campagnes, groupes d'annonces, mots-clés, conversions) et peuvent se connecter à Google Sheets, Google Drive, BigQuery ou à des API externes (présentation des scripts Google Ads).

Ce que les scripts permettent de faire

  • Lire et modifier : enchères, états, budgets, annonces
  • Créer : mots-clés, annonces
  • Rapporter : extraire des données vers Google Sheets ou par e-mail
  • Surveiller : détecter les anomalies (budget consommé trop tôt, campagne sans impression)
  • Intégrer : utiliser des données externes (météo, stocks, prix) pour ajuster les campagnes

Différence avec les règles automatiques

Google Ads propose aussi des règles automatiques, configurées sans code depuis Outils > Règles. Les scripts vont plus loin :

CritèreRègles automatiquesScripts
Complexité logiqueConditions simplesLogique conditionnelle complète
Sources de donnéesDonnées Google AdsGoogle Ads, Sheets, API externes
Actions disponiblesÉtat, budget, enchères, e-mailsPresque tout ce que permet l'interface
Courbe d'apprentissageAucuneBases de JavaScript
Mise en placeFormulaire dans l'interfaceCode à coller, tester et autoriser

Installer un script : procédure pas à pas

Accéder à l'éditeur de scripts

D'après l'aide Google Ads sur les scripts :

  1. Dans Google Ads, cliquez sur l'icône Outils
  2. Ouvrez le menu Actions groupées, puis Scripts
  3. Cliquez sur le bouton + pour créer un script
  4. Donnez-lui un nom explicite (vous en aurez plusieurs)

Coller et tester le code

  1. Effacez le code par défaut dans l'éditeur
  2. Collez votre script
  3. Cliquez sur Prévisualiser pour voir les modifications que le script ferait, sans les appliquer
  4. Lisez les journaux pour détecter les erreurs
  5. Si l'aperçu est satisfaisant, cliquez sur Exécuter

Attention : l'aperçu ne bloque que les modifications passées par AdsApp. Un e-mail envoyé avec MailApp part réellement et une feuille Google Sheets est réellement modifiée, même en aperçu (documentation du mode aperçu).

Paramétrer la fréquence d'exécution

Après avoir enregistré le script, planifiez-le. L'aide Google Ads et la documentation pour les développeurs prévoient des exécutions :

  • toutes les heures, pour la surveillance ;
  • quotidiennes, à une heure précise, pour les rapports et ajustements ;
  • hebdomadaires, pour les contrôles réguliers ;
  • mensuelles, pour les récapitulatifs ;
  • ou une seule fois, à une date donnée.

Important : en JavaScript, l'objet Date d'un script utilise par défaut le fuseau America/Los_Angeles, quel que soit celui du compte. Google recommande d'utiliser Utilities.formatDate() avec le fuseau renvoyé par AdsApp.currentAccount().getTimeZone() (documentation sur les dates).

Autorisations requises

Avant le premier aperçu ou la première exécution, Google demande d'autoriser le script à accéder à votre compte (« Autoriser maintenant », puis « Accorder l'accès »). Les scripts qui écrivent dans Google Sheets ou envoient des e-mails demandent des autorisations supplémentaires. Lisez-les avant d'accepter.

5 scripts utiles à installer

Les exemples ci-dessous utilisent les noms de colonnes de la syntaxe actuelle (metrics.cost_micros, campaign.status), documentée dans la référence AdsApp. Les anciens noms (Cost, Status, QualityScore) que l'on trouve dans de vieux tutoriels ne figurent plus dans cette référence. Les montants y sont exprimés en micros : 50 € = 50 000 000.

Script 1 : mise en veille des mots-clés sans conversion

Ce script analyse vos mots-clés actifs et met en veille ceux qui ont dépensé plus d'un seuil donné sans conversion sur les N derniers jours.

// Met en veille les mots-clés qui dépensent sans convertir
var COST_THRESHOLD = 50; // euros
var LOOKBACK_DAYS = 30;
var SEND_EMAIL = true;
var EMAIL_ADDRESS = "votre@email.com";

function main() {
  var report = [];
  var range = getDateRange(LOOKBACK_DAYS);

  var keywordIterator = AdsApp.keywords()
    .withCondition("campaign.status = ENABLED")
    .withCondition("ad_group.status = ENABLED")
    .withCondition("ad_group_criterion.status = ENABLED")
    .withCondition("metrics.cost_micros > " + COST_THRESHOLD * 1000000)
    .withCondition("metrics.conversions < 1")
    .forDateRange(range.from, range.to)
    .get();

  while (keywordIterator.hasNext()) {
    var keyword = keywordIterator.next();
    var stats = keyword.getStatsFor(range.from, range.to);
    keyword.pause();
    report.push(keyword.getText() + " | " +
                keyword.getCampaign().getName() + " | " +
                stats.getCost().toFixed(2) + " €");
  }

  if (SEND_EMAIL && report.length > 0) {
    MailApp.sendEmail(EMAIL_ADDRESS,
      "Mots-clés mis en veille : " + range.to,
      report.join("\n"));
  }

  Logger.log(report.length + " mots-clés mis en veille.");
}

function getDateRange(days) {
  var timeZone = AdsApp.currentAccount().getTimeZone();
  var end = new Date();
  var start = new Date(end.getTime() - days * 24 * 60 * 60 * 1000);
  return {
    from: Utilities.formatDate(start, timeZone, "yyyyMMdd"),
    to: Utilities.formatDate(end, timeZone, "yyyyMMdd")
  };
}

Paramètres à ajuster :

  • COST_THRESHOLD : le seuil de dépense en euros (repère courant : deux à trois fois votre CPA cible)
  • LOOKBACK_DAYS : la fenêtre d'analyse (30 jours conviennent à la plupart des comptes)
  • EMAIL_ADDRESS : l'adresse qui reçoit la liste des mots-clés mis en veille

En aperçu, aucun mot-clé n'est mis en veille, mais l'e-mail est bien envoyé.

Script 2 : rapport de performance quotidien vers Google Sheets

Ce script ajoute chaque jour les métriques de la veille de vos campagnes dans une feuille Google Sheets. Le choix des indicateurs à y suivre est détaillé dans notre guide pour mesurer la performance de ses campagnes Google Ads.

var SPREADSHEET_URL = "https://docs.google.com/spreadsheets/d/VOTRE_ID/";

function main() {
  var spreadsheet = SpreadsheetApp.openByUrl(SPREADSHEET_URL);
  var sheet = spreadsheet.getSheetByName("Données") ||
              spreadsheet.insertSheet("Données");
  var timeZone = AdsApp.currentAccount().getTimeZone();
  var today = Utilities.formatDate(new Date(), timeZone, "yyyy-MM-dd");

  var campaignIterator = AdsApp.campaigns()
    .withCondition("campaign.status = ENABLED")
    .forDateRange("YESTERDAY")
    .get();

  while (campaignIterator.hasNext()) {
    var campaign = campaignIterator.next();
    var stats = campaign.getStatsFor("YESTERDAY");

    sheet.appendRow([
      today,
      campaign.getName(),
      stats.getImpressions(),
      stats.getClicks(),
      (stats.getCtr() * 100).toFixed(2) + "%",
      stats.getCost().toFixed(2),
      stats.getConversions(),
      stats.getConversions() > 0 ?
        (stats.getCost() / stats.getConversions()).toFixed(2) : "N/A"
    ]);
  }
}

AdsApp.campaigns() ne renvoie que les campagnes sur le Réseau de Recherche et Display. Pour Shopping, Performance Max ou vidéo, il faut utiliser AdsApp.shoppingCampaigns(), AdsApp.performanceMaxCampaigns() ou AdsApp.videoCampaigns() (référence AdsApp).

Script 3 : alerte de budget consommé trop tôt

Ce script, planifié toutes les heures, envoie une alerte si une campagne a déjà consommé 80 % de son budget quotidien avant 18 h (heure du compte).

var ALERT_THRESHOLD = 0.80; // 80 % du budget
var EMAIL_ADDRESS = "votre@email.com";
var ALERT_HOUR = 18; // n'alerter qu'avant 18 h

function main() {
  var timeZone = AdsApp.currentAccount().getTimeZone();
  var currentHour = parseInt(Utilities.formatDate(new Date(), timeZone, "H"), 10);
  if (currentHour >= ALERT_HOUR) return;

  var alerts = [];
  var campaignIterator = AdsApp.campaigns()
    .withCondition("campaign.status = ENABLED")
    .forDateRange("TODAY")
    .get();

  while (campaignIterator.hasNext()) {
    var campaign = campaignIterator.next();
    var budget = campaign.getBudget().getAmount();
    var spent = campaign.getStatsFor("TODAY").getCost();
    var ratio = spent / budget;

    if (ratio >= ALERT_THRESHOLD) {
      alerts.push(campaign.getName() +
                  " : " + (ratio * 100).toFixed(0) + " % du budget utilisé" +
                  " (" + spent.toFixed(2) + " € / " + budget.toFixed(2) + " €)");
    }
  }

  if (alerts.length > 0) {
    MailApp.sendEmail(EMAIL_ADDRESS,
      "Alerte budget Google Ads",
      alerts.join("\n"));
  }
}

Les données du jour peuvent avoir quelques heures de retard : traitez cette alerte comme un signal, pas comme un relevé exact.

Script 4 : baisse d'enchère selon le niveau de qualité

Ce script repère les mots-clés dont le niveau de qualité est faible (4 ou moins) et baisse leur enchère au CPC. Il n'a d'effet que sur les campagnes au CPC manuel : avec une stratégie automatique, Google fixe lui-même les enchères.

var LOW_QS_THRESHOLD = 4;
var BID_REDUCTION_FACTOR = 0.80; // ramène l'enchère à 80 %
var MIN_BID = 0.05; // enchère minimale en euros

function main() {
  var keywordIterator = AdsApp.keywords()
    .withCondition("ad_group_criterion.status = ENABLED")
    .withCondition("ad_group.status = ENABLED")
    .withCondition("campaign.status = ENABLED")
    .withCondition("ad_group_criterion.quality_info.quality_score <= " + LOW_QS_THRESHOLD)
    .get();

  var count = 0;
  while (keywordIterator.hasNext()) {
    var keyword = keywordIterator.next();
    var currentBid = keyword.bidding().getCpc();
    if (!currentBid) continue;
    var newBid = Math.max(currentBid * BID_REDUCTION_FACTOR, MIN_BID);
    keyword.bidding().setCpc(newBid);
    count++;
  }

  Logger.log(count + " enchères ajustées pour niveau de qualité faible.");
}

Ne le planifiez pas chaque jour : il baisserait l'enchère à chaque exécution. Une exécution manuelle après analyse suffit.

Script 5 : détection des annonces sans impression

Ce script liste les annonces activées qui n'ont généré aucune impression sur les 14 derniers jours.

function main() {
  var noImpressionAds = [];

  var adIterator = AdsApp.ads()
    .withCondition("ad_group_ad.status = ENABLED")
    .withCondition("ad_group.status = ENABLED")
    .withCondition("campaign.status = ENABLED")
    .withCondition("metrics.impressions = 0")
    .forDateRange("LAST_14_DAYS")
    .get();

  while (adIterator.hasNext()) {
    var ad = adIterator.next();
    noImpressionAds.push(
      ad.getCampaign().getName() + " > " +
      ad.getAdGroup().getName() + " > annonce " +
      ad.getId() + " (" + ad.getType() + ")"
    );
  }

  Logger.log("Annonces sans impression : " + noImpressionAds.length);
  noImpressionAds.forEach(function(line) { Logger.log(line); });
}

L'ancienne méthode getHeadlinePart1(), souvent recopiée, ne concerne que les annonces textuelles grand format, qui ne peuvent plus être créées depuis 2022. Ce script identifie donc les annonces par leur numéro et leur type.

Bibliothèques de scripts gratuits

Vous n'avez pas à tout écrire vous-même :

  • Solutions officielles de Google : des scripts prêts à l'emploi (rapports de compte, vérification des liens, budgets) publiés sur le site des développeurs Google Ads
  • Brainlabs : une collection de scripts open source sur GitHub, dont certains n'ont pas été mis à jour récemment
  • Exemples de la documentation : l'éditeur de scripts propose une section Documentation avec des exemples à copier et adapter

Vérifiez qu'un script tiers utilise la syntaxe actuelle avant de l'installer.

Les limites des scripts Google Ads

Limites techniques

Valeurs tirées de la page des limites des scripts Google Ads, consultée le 5 novembre 2026 :

LimiteValeur
Durée d'exécution max.30 minutes (60 minutes pour certains scripts de compte administrateur en parallèle)
Résultats renvoyés par un itérateur50 000 par défaut, modifiable avec withLimit()
ID dans withIds()Moins de 10 000
Comptes traités en parallèle (compte administrateur)50
Scripts autorisés par compte250
Fréquence maximaleToutes les heures

Ce que les scripts ne remplacent pas

Les scripts automatisent les tâches répétitives, mais ne remplacent pas le jugement sur :

  • la stratégie d'enchères (CPA cible, ROAS)
  • la création et l'amélioration des annonces
  • l'analyse des opportunités de croissance
  • les décisions de restructuration de compte, qui partent d'un audit du compte Google Ads

Risques à connaître

  • Un script mal configuré peut mettre en veille des mots-clés rentables ou modifier des enchères à tort. Testez toujours en aperçu, en gardant en tête que les e-mails partent quand même.
  • Un script accède à l'ensemble du compte : vérifiez sa provenance avant de l'installer.
  • Google fait évoluer la syntaxe des scripts : un script ancien peut cesser de fonctionner. Relisez vos scripts quand Google annonce un changement.

FAQ : Scripts Google Ads

Faut-il savoir coder pour utiliser les scripts Google Ads ?

Pas nécessairement. Pour un script existant, il suffit souvent de copier le code et d'ajuster quelques variables documentées en tête de fichier. Les bases du JavaScript (variables, conditions, boucles) suffisent pour l'adapter. Pour écrire un script complet, un niveau intermédiaire est préférable.

Les scripts fonctionnent-ils sur les comptes administrateur (MCC) ?

Oui. Les scripts de compte administrateur traitent plusieurs comptes clients en une exécution, jusqu'à 50 comptes en parallèle avec executeInParallel. Ils servent surtout aux alertes et aux rapports consolidés.

Un script peut-il accéder aux données Performance Max ?

Oui, en partie. AdsApp.performanceMaxCampaigns() donne accès aux campagnes PMax, à leurs statistiques, à leur budget et à leurs groupes de composants. Un script peut ajouter ou retirer des composants dans un groupe existant, mais ne peut pas créer de groupe de composants ; la création de campagnes passe par la fonction mutate (documentation Performance Max pour les scripts).

Que se passe-t-il si un script génère une erreur ou dépasse la durée maximale ?

Le script s'arrête, mais les modifications faites avant l'arrêt sont conservées. Une modification partielle est donc possible. Consultez les journaux de chaque exécution dans l'historique des scripts, et faites écrire vos scripts dans un journal ou une feuille de calcul au fur et à mesure.

Sources et liens cités

  1. [1]présentation des scripts Google Adsdevelopers.google.com
  2. [2]règles automatiquessupport.google.com
  3. [3]aide Google Ads sur les scriptssupport.google.com
  4. [4]documentation du mode aperçudevelopers.google.com
  5. [5]documentation sur les datesdevelopers.google.com
  6. [6]référence AdsAppdevelopers.google.com
  7. [7]référence AdsAppdevelopers.google.com
  8. [8]site des développeurs Google Adsdevelopers.google.com
  9. [9]GitHubgithub.com
  10. [10]page des limites des scripts Google Adsdevelopers.google.com
  11. [11]documentation Performance Max pour les scriptsdevelopers.google.com