Les scripts Google Ads fournissent une plate-forme d'automatisation sans serveur qui vous permet de gérer et d'interroger vos données Google Ads de manière programmatique à l'aide de JavaScript moderne (ES6+) dans un IDE basé sur un navigateur. Les scripts Google Ads vous permettent d'automatiser les workflows de gestion de compte de routine, de générer des rapports personnalisés et d'intégrer Google Ads à des sources de données externes (sur un ou plusieurs milliers de comptes) sans provisionner de serveurs ni gérer d'identifiants de développeur.
La plupart des fonctionnalités de Google Ads sont disponibles dans les scripts Google Ads via les appels mutate et search. Vous pouvez utiliser des scripts pour :
- Gérer les campagnes, les groupes d'annonces, les mots clés et les annonces
- Ajustez les enchères, les budgets et l'état en fonction des performances en temps réel ou de données externes.
- Exécutez des requêtes à l'aide du langage de requête Google Ads (GAQL) pour générer des rapports et des tableaux de bord personnalisés.
- Planifiez des exécutions automatisées toutes les heures, tous les jours, toutes les semaines, tous les mois ou à la demande.
- Coordonnez les opérations multicomptes sur les comptes enfants à l'aide de scripts administrateur.
- Connectez-vous aux services Google Workspace (comme Sheets et Drive), aux services Google Cloud (comme BigQuery) et aux API tierces.
Les scripts incluent également des sélecteurs d'entités et des rapports intégrés.
Caractéristiques techniques clés
Les caractéristiques techniques suivantes définissent l'environnement d'exécution et les limites opérationnelles des scripts Google Ads :
| Spécification | Script pour un seul compte | Script de compte administrateur |
|---|---|---|
| Délai avant expiration de l'exécution | 30 minutes maximum |
Jusqu'à 60 minutes avec executeInParallel et un rappel (30 minutes par défaut)
|
| Moteur d'exécution | Environnement d'exécution JavaScript V8 (ECMAScript 6+) | Environnement d'exécution JavaScript V8 (ECMAScript 6+) |
| Limite d'itérateurs d'entités | 50 000 entités par défaut par itérateur (les rapports et les requêtes de recherche sont exemptés) | 50 000 entités par compte enfant (les rapports et les requêtes de recherche sont exemptés) |
| Comptes parallèles | N/A (1 compte) | Jusqu'à 50 comptes en parallèle |
| Limite d'importation groupée | Taille de fichier de 50 Mo, 1 000 000 de lignes | Taille de fichier de 50 Mo, 1 000 000 de lignes |
| Scripts autorisés | Jusqu'à 250 scripts autorisés par utilisateur | Jusqu'à 250 scripts autorisés par utilisateur |
| Hébergement et infrastructure | Entièrement géré par Google (sans serveur) | Entièrement géré par Google (sans serveur) |
Pour en savoir plus, consultez la section Limites.
Les scripts Google Ads sont-ils le produit qu'il me faut ?
Google propose plusieurs produits pour vous aider à automatiser vos comptes Google Ads. Le tableau suivant présente des scénarios courants et des recommandations pour vous aider à choisir le produit adapté à vos besoins :
| Scénario | Recommandation | Principales caractéristiques |
|---|---|---|
| Je suis un développeur qui souhaite créer son propre produit logiciel ou l'intégrer à l'API Google Ads. Je suis à l'aise avec l'écriture de code et la gestion d'infrastructures logicielles, y compris les serveurs et les bases de données. | Utilisez l'API Google Ads. | Contrôle total des API, débit plus élevé, hébergement dédié et gestion OAuth. |
| Je suis un développeur qui sait écrire du code, mais je préfère ne pas gérer ma propre infrastructure logicielle. | Utilisez les scripts Google Ads. | Exécution sans serveur dans Google Ads, planification automatisée, IDE basé sur un navigateur. |
| Je ne suis pas développeur, mais je suis prêt à consacrer du temps à l'apprentissage de la programmation pour automatiser Google Ads. | Utilisez les scripts Google Ads. | Syntaxe JavaScript simple, modèles de scripts prédéfinis, saisie semi-automatique de l'IDE et mise en surbrillance de la syntaxe. |
| Je souhaite gérer des campagnes vidéo de manière programmatique. | Utilisez les scripts Google Ads. |
Gestion directe des campagnes vidéo à l'aide de AdsApp.videoCampaigns().
|
| Je souhaite planifier l'exécution de tâches sans avoir besoin d'une session utilisateur active. | Utilisez les scripts Google Ads. | Autorisation en arrière-plan OAuth2 avec planification automatisée toutes les heures, tous les jours, toutes les semaines ou tous les mois. |
| Je souhaite accéder à mes comptes Google Ads imbriqués de manière programmatique. | Utilisez des scripts administrateur pour accéder aux comptes enfants actifs à partir d'un seul script. |
Itération séquentielle sur les comptes enfants ou exécution parallèle sur un maximum de 50 comptes enfants à l'aide de executeInParallel.
|
| Je souhaite intégrer des API Google ou tierces dans ma gestion de Google Ads. | Utilisez les API Google ou des API tierces avec les scripts Google Ads. |
Services Google Workspace intégrés (Sheets, Drive, Mail), API Google avancées (BigQuery, Analytics, YouTube) et UrlFetchApp pour les API REST externes.
|
| Je suis analyste de données (ou j'occupe un poste similaire) et je souhaite télécharger des rapports Google Ads pour les analyser plus en détail. | Utilisez le service de transfert de données BigQuery pour Google Ads. | Pipeline automatisé et planifié pour les données Google Ads dans BigQuery sans code. |
| Je souhaite gérer Google Ads de manière groupée et l'écriture de code ne me dérange pas. | Utilisez les importations groupées avec les scripts Google Ads. | Importation programmatique de fichiers CSV ou de feuilles de calcul pouvant contenir jusqu'à 1 000 000 de lignes. |
| Je souhaite gérer Google Ads de manière groupée, mais je ne veux pas écrire de code. | Utilisez des règles automatiques, des importations groupées ou Google Ads Editor. | Outils de bureau ou d'interface utilisateur sans code pour les mises à jour groupées et les règles planifiées. |
Prérequis
Seules des connaissances de base en JavaScript sont nécessaires. L'IDE facilite la mise en surbrillance de la syntaxe, la saisie semi-automatique et l'aperçu. Il vous suffit de disposer d'un compte Google Ads pour commencer à écrire votre premier script.
Questions fréquentes
Trouvez les réponses aux questions courantes sur l'architecture, les limites d'exécution et les intégrations des scripts Google Ads.
Qu'est-ce que les scripts Google Ads ?
Les scripts Google Ads fournissent un environnement d'automatisation sans serveur dans Google Ads. Ils permettent aux annonceurs et aux développeurs d'écrire du code JavaScript pour interroger les métriques de performances, créer et modifier des campagnes, mettre à jour les enchères et les budgets, et se connecter à des API externes sans configurer de serveurs, gérer de jetons OAuth ni payer pour l'infrastructure.
Quelle est la différence entre les scripts Google Ads et l'API Google Ads ?
Les scripts Google Ads s'exécutent directement dans votre compte Google Ads à l'aide de JavaScript. Ils ne nécessitent aucune infrastructure de serveur et gèrent l'autorisation automatiquement dans le navigateur. L'API Google Ads est une API REST et gRPC conçue pour les applications d'entreprise à grande échelle, les outils tiers et les pipelines de données à volume élevé qui s'exécutent sur vos propres serveurs et nécessitent des jetons de développeur et des identifiants OAuth dédiés.
Ai-je besoin d'un serveur pour exécuter des scripts Google Ads ?
Non. Les scripts Google Ads s'exécutent entièrement sur l'infrastructure cloud de Google, sans frais supplémentaires. Vous pouvez créer des scripts, les tester en mode Aperçu et les planifier directement dans l'interface Web de Google Ads.
Quelles sont les limites d'exécution des scripts Google Ads ?
Les scripts standards des comptes individuels peuvent s'exécuter pendant 30 minutes maximum par exécution. Les scripts de compte administrateur qui utilisent executeInParallel peuvent s'exécuter pendant 60 minutes maximum sur 50 comptes enfants au plus (lorsqu'une fonction de rappel est spécifiée). Si un script expire, Google Ads applique tout de même les modifications effectuées avant l'annulation. Pour en savoir plus sur les délais avant expiration, les quotas et les limites d'importation groupée, consultez Limites.
Les scripts Google Ads peuvent-ils se connecter à des API externes ?
Oui. Les scripts Google Ads incluent des services intégrés tels que SpreadsheetApp pour lire et écrire des feuilles de calcul Google Sheets, UrlFetchApp pour envoyer des requêtes HTTP à des API REST externes, et les API Google avancées pour l'intégration à des services tels que BigQuery et YouTube. Pour en savoir plus, consultez API tierces et API Google avancées.
Commentaires
Si vous avez des commentaires sur les scripts Google Ads, n'hésitez pas à nous en faire part. Contactez-nous sur Discord.
Si vous avez besoin d'aide, contactez l'assistance technique pour les scripts.