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. Avec les scripts Google Ads, vous pouvez automatiser les workflows de gestion de compte de routine, générer des rapports personnalisés et intégrer Google Ads à des sources de données externes (pour un compte ou des 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 des appels de mutation et de recherche. Vous pouvez utiliser des scripts pour :
- gérer les campagnes, les groupes d'annonces, les mots clés, et les annonces ;
- ajuster les enchères, les budgets et l'état en fonction des performances en temps réel ou des données externes ;
- exécuter 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 ;
- planifier des exécutions automatiques toutes les heures, tous les jours, toutes les semaines, tous les mois ou à la demande ;
- coordonner les opérations multi-comptes dans les comptes enfants à l'aide de scripts administrateur ;
- vous connecter aux services Google Workspace (tels que Sheets et Drive), aux services Google Cloud (tels que 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 pour un compte administrateur |
|---|---|---|
| Délai d'exécution | 30 minutes maximum |
Jusqu'à 60 minutes avec executeInParallel et un rappel
(30 minutes par défaut)
|
| Moteur d'exécution | Exécution JavaScript V8 (ECMAScript 6+) | 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 exclus) | 50 000 entités par compte enfant (les rapports et les requêtes de recherche sont exclus) |
| Comptes parallèles | Non applicable (1 compte) | Jusqu'à 50 comptes en parallèle |
| Limite d'importation groupée | Taille de fichier : 50 Mo, 1 000 000 de lignes | Taille de fichier : 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 adapté à mes besoins ?
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 s'intégrer à l'API Google Ads. Je suis à l'aise avec l'écriture de code et la gestion de l'infrastructure logicielle y compris les serveurs et les bases de données. | Utilisez l'API Google Ads. | Contrôle total de l'API, débit plus élevé, hébergement dédié et gestion OAuth. |
| Je suis un développeur à l'aise avec l'écriture de 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 et mise en surbrillance de la syntaxe dans l'IDE. |
| Je souhaite gérer les 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 de gestion pour accéder aux comptes enfants diffusés à partir d'un seul script. |
Itération séquentielle dans les comptes enfants ou exécution parallèle dans
un maximum de 50 comptes enfants à l'aide de executeInParallel.
|
| Je souhaite intégrer des API Google ou tierces dans ma gestion Google Ads management. | Utilisez les Google API ou les tierces API 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 un analyste de données (ou un rôle similaire) qui souhaite télécharger des rapports Google Ads pour une analyse plus approfondie. | Utilisez le service de transfert de données BigQuery pour Google Ads. | Pipeline automatisé planifié pour les données relatives aux annonces Google Ads dans BigQuery sans code. |
| Je souhaite gérer Google Ads de manière groupée et cela ne me dérange pas d'écrire du code. | 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 vous aide grâce à la mise en surbrillance de la syntaxe, à la saisie semi-automatique et à la prévisualisation. Il vous suffit 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.
Que sont 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 d'infrastructure.
En quoi les scripts Google Ads diffèrent-ils de l'API Google Ads ?
Les scripts Google Ads s'exécutent directement dans votre compte Google Ads à l'aide de JavaScript, ne nécessitent aucune infrastructure de serveur et gèrent automatiquement l'autorisation 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 dédiés et des identifiants OAuth.
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çuet les planifier directement dans l'interface Web de Google Ads.
Quelles sont les limites d'exécution des scripts Google Ads ?
Les scripts standards dans les comptes individuels peuvent s'exécuter jusqu'à 30 minutes par exécution. Les scripts de compte administrateur qui utilisent executeInParallel peuvent s'exécuter jusqu'à 60 minutes dans un maximum de 50 comptes enfants (lorsqu'une fonction de rappel est spécifiée). Si un script expire, Google Ads applique quand même les modifications apportées avant l'annulation. Pour obtenir des informations complètes sur les délais d'attente, les quotas et les limites d'importation groupée, consultez la section 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 des API Google avancées pour s'intégrer à des services tels que BigQuery et YouTube. Pour en savoir plus, consultez la section
API tierces
et API Google avancées.
Commentaires
N'hésitez pas à nous faire part de vos commentaires sur les scripts Google Ads. Contactez-nous sur Discord.
Si vous avez besoin d'aide, contactez l'assistance technique pour les scripts.