Scripts Google Ads · API · Apps Script

Scripts Google Ads
sur mesure.

Quand l'interface de Google Ads ne fait pas ce dont vous avez besoin, on l'écrit. Alertes, règles branchées sur vos marges, reporting, suivi de dizaines de comptes : nous gérons des campagnes et nous codons les outils pour les piloter, depuis l'époque d'AdWords.

Requête GAQL · Performance Max par réseau
SELECT
  campaign.name,
  segments.ad_network_type,
  metrics.cost_micros,
  metrics.conversions
FROM campaign
WHERE
  campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC

Ce que l'interface ne montre pas : la dépense et les conversions d'une Performance Max, réseau par réseau (Search, Display, YouTube…).

Ce qu'on code

Six problèmes, six scripts.

Alertes

Vous découvrez un problème en fin de mois, dans le rapport.

Un email dès qu'une campagne dépense sans convertir, que les conversions cessent de remonter ou qu'une annonce est refusée. Dans notre exemple de rapport, les demandes de devis n'ont plus été comptées pendant trois semaines après une mise à jour du site : une alerte le signale dès le premier jour.

Règles métier

Les stratégies d'enchères de Google ne connaissent ni vos marges, ni vos stocks, ni votre planning.

Des règles qui ajustent budgets, enchères ou statuts à partir de vos données : marge par produit, stock, capacité de vos équipes à traiter les demandes, dates d'opérations commerciales.

Réseaux et multi-comptes

Un compte par point de vente ou par franchisé, et personne pour tous les surveiller.

Des scripts au niveau du compte administrateur (MCC) : les mêmes contrôles, alertes et règles appliqués à tout le réseau, et un suivi par compte. Nos outils internes suivent ainsi chaque jour des milliers de campagnes.

Reporting automatique

Les mêmes exports CSV, refaits à la main chaque mois.

Un Google Sheets mis à jour chaque matin, un email mensuel par client, un rapport HTML interactif, avec ce que l'interface ne montre pas, comme la Performance Max découpée par réseau. Voir le script d'email mensuel.

Recherches et annonces

Des recherches hors sujet qui coûtent, des annonces qui vieillissent.

Analyse des termes de recherche, exclusion automatique des marques concurrentes, contrôle de cohérence entre la recherche et la page de destination, mise à jour programmée des titres d'annonces.

Données hors Google Ads

Vos ventes et vos leads vivent dans le CRM, pas dans Google Ads.

Croisement avec votre CRM, vos marges, vos appels ou votre outil d'analytics par l'API Google Ads. Routage des leads des formulaires Google Ads vers votre CRM, un email ou un webhook, comme le fait notre outil PushMyLead.

Le bon outil

Script, Apps Script ou API ?

« Script Google Ads » désigne souvent trois choses différentes. Le choix dépend du volume, du nombre de comptes et des données à croiser : c'est la première chose que nous tranchons avec vous.

Script Google Ads

JavaScript, dans votre compte

Alertes, contrôles et règles sur un compte ou un compte administrateur. Planifié par Google, sans serveur : vous le voyez et le lisez dans votre compte.

Limite : Temps d'exécution limité, peu adapté aux gros volumes de données externes.

Google Apps Script et Sheets

JavaScript, dans Google Workspace

Quand votre équipe veut voir ou régler les paramètres dans un tableur : seuils d'alerte, budgets par point de vente, rapports partagés.

Limite : Le tableur devient la source de vérité : il faut le protéger contre les modifications accidentelles.

API Google Ads

Python et GAQL, hors du compte

Des centaines de comptes, plusieurs années d'historique, des données croisées avec un CRM ou des marges, des outils internes complets.

Limite : Plus long à mettre en place, et à maintenir quand Google publie une nouvelle version de l'API.

Notre profil technique

Des gestionnaires de campagnes qui codent.

Un script utile se conçoit avec la connaissance du compte : ce qu'un développeur seul ne voit pas, c'est quelle alerte réveillera quelqu'un pour rien, et quelle règle fera perdre des ventes. Chez Jabiroo, les outils sont écrits par l'équipe qui pilote les campagnes.

  • Scripts Google Ads (JavaScript)
  • API Google Ads et GAQL (Python)
  • Google Apps Script
  • Google Sheets
  • API GA4
  • API Google Tag Manager
  • Comptes administrateur (MCC)
  • Webhooks
  • Emails automatiques
  • Tâches planifiées
  1. 2014

    SunnyReports, application de reporting construite sur l'API AdWords, AWQL.me, une console gratuite pour tester les requêtes de l'API, et nos premiers scripts AdWords publiés sur ce site, réécrits depuis pour Google Ads.

  2. Depuis

    Chaque changement suivi : AdWordsApp devenu AdsApp, AWQL remplacé par GAQL, l'API AdWords par l'API Google Ads.

  3. Aujourd'hui

    Des outils internes qui suivent chaque jour des milliers de campagnes pour un réseau de plus de 250 franchisés.

Exemple

Une alerte en vingt lignes

Ce script Google Ads liste chaque jour les campagnes qui ont dépensé plus de 50 € en 7 jours sans aucune conversion, et vous les envoie par email. C'est le point de départ ; en production, on ajoute ce qui manque ici : seuils par campagne, historique pour ne pas répéter la même alerte, comparaison avec la période précédente.

D'autres scripts sont publiés en accès libre et expliqués pas à pas :

Script Google Ads · alerte-sans-conversion.js
// Alerte : campagnes qui dépensent sans convertir depuis 7 jours
const SEUIL_EUROS = 50;
const DESTINATAIRE = '[email protected]';

function main() {
  const lignes = AdsApp.search(
    'SELECT campaign.name, metrics.cost_micros, metrics.conversions ' +
    "FROM campaign WHERE campaign.status = 'ENABLED' " +
    'AND segments.date DURING LAST_7_DAYS'
  );
  const alertes = [];
  while (lignes.hasNext()) {
    const l = lignes.next();
    const cout = Number(l.metrics.costMicros || 0) / 1e6;
    if (cout >= SEUIL_EUROS && !l.metrics.conversions) {
      alertes.push(l.campaign.name + ' : ' + cout.toFixed(0) + ' € dépensés');
    }
  }
  if (alertes.length > 0) {
    MailApp.sendEmail(DESTINATAIRE, 'Sans conversion', alertes.join('\n'));
  }
}

Comment on travaille

Un script ne touche à votre compte
qu'une fois qu'on sait ce qu'il fera.

  1. Le besoin, pas la technique

    Quelle décision le script doit-il faciliter, qui lit le résultat, à quelle fréquence. Souvent, la bonne réponse est plus simple que la demande de départ.

  2. Le bon outil

    Script dans le compte, Apps Script ou programme sur l'API Google Ads, selon le volume, le nombre de comptes et les données à croiser.

  3. Lecture seule d'abord

    Le script commence par lire et vous montrer ce qu'il ferait, sur vos vraies données, avant de toucher à quoi que ce soit.

  4. Écriture sous contrôle

    Quand un script modifie un compte, il passe d'abord en simulation, avec des garde-fous (plafonds, listes d'exclusion), et chaque modification est consignée dans un journal.

  5. En production, surveillé

    Exécutions planifiées, alerte par email si une exécution échoue, et mise à jour quand Google fait évoluer ses scripts ou son API.

Questions fréquentes

Avant de commander un script

Besoin d'outils au-delà de Google Ads (Apps Script, extraction de données, analyses) ? Voir nos outils sur-mesure.

Faut-il vous confier la gestion de nos campagnes ?

Non. Les scripts et les outils sur mesure se commandent seuls, y compris pour une équipe qui gère ses campagnes elle-même. Si vous voulez aussi déléguer la gestion, voir externaliser sa gestion Google Ads.

Où tourne le script ?

Un script Google Ads s'installe dans votre compte, ou dans votre compte administrateur : vous le voyez, vous pouvez le lire, Google le lance aux heures prévues. Un Apps Script vit dans votre Google Workspace. Les programmes qui utilisent l'API Google Ads tournent en dehors du compte, de façon planifiée.

Un script peut-il modifier nos campagnes sans contrôle ?

Pas chez nous. Un script commence en lecture seule ; quand il doit modifier le compte, il passe d'abord en simulation, avec des plafonds et des exclusions, et chaque modification est journalisée. Vous savez toujours ce qui a changé, quand et pourquoi.

Pouvez-vous reprendre un script existant ?

Oui : on le relit, on le corrige ou on le réécrit. Les scripts écrits avant 2022 utilisent souvent des fonctions ou des rapports que Google a retirés depuis ; ce guide sur GAQL explique ce qui a changé.

Combien coûte un script sur mesure ?

Ça dépend de ce qu'il fait et de l'outil retenu : une alerte simple n'a rien à voir avec un outil multi-comptes branché sur un CRM. On vous fait une proposition après un premier échange sur le besoin, en prévoyant la maintenance quand elle est nécessaire.

Faites-vous aussi l'audit de nos campagnes ?

Oui. L'audit de positionnement Google Ads s'appuie sur les mêmes outils : extraction par l'API, historique long, Performance Max découpée par réseau. Il fait souvent apparaître les contrôles qui méritent d'être automatisés.

Ce que votre compte devrait faire tout seul.

Décrivez la tâche répétitive ou le contrôle qui vous manque. On vous répond sous 48 h ouvrées.

Décrire votre besoin