Google Ads Master

• Vous configurez un nouveau compte Google Ads ou intégrez un compte existant et devez collecter la configuration, les actions de conversion, les budgets et les contraintes avant de toucher quoi que ce soit.
• Vous souhaitez des rapports de performance au niveau des campagnes ou des mots-clés — CTR, ROAS, Search Impression Share, CPA — interprétés par rapport à votre action de conversion principale réelle plutôt qu'aux totaux mixtes de l'interface utilisateur.
• Vous devez investiguer un CTR faible, diagnostiquer des écarts de valeur de conversion ou analyser les données de termes de recherche et de géographie pour prendre des décisions d'enchères, de négatifs ou de segmentation.
• Vous souhaitez créer de nouvelles campagnes Search, groupes d'annonces ou mots-clés en état mis en pause à partir d'une spécification structurée, avec une relecture GAQL post-écriture pour confirmer ce qui a été créé.

• Vous devez gérer des types de campagnes non liées à la Recherche ou des plateformes en dehors de Google Ads — cette compétence est limitée aux workflows Google Ads Search.
• Vous souhaitez une optimisation de campagne entièrement automatisée, sans intervention humaine et sans étape de confirmation ; cette compétence requiert une autorisation explicite avant toute opération d'écriture.
• Vous n'avez pas encore complété l'intégration minimale (identifiant client, authentification, fuseau horaire des rapports, action de conversion principale) — la compétence vous invitera à fournir ces informations avant de procéder à toute analyse ou opération d'écriture.

Avant toute analyse ou modification de compte, Google Ads Master collecte un ensemble minimal de données obligatoires : l'identifiant client, le chemin OAuth/auth, le token développeur, le fuseau horaire de reporting, le modèle commercial, l'action de conversion principale, les objectifs ROAS/CPA, ainsi que les autorisations d'écriture. Cela évite d'agir sur un contexte de compte incomplet ou inadapté.

Toute création de campagne, de groupe d'annonces et de mot-clé est définie par défaut sur le statut PAUSÉ, sauf si l'utilisateur en décide explicitement autrement. Les budgets et les enchères ne sont jamais modifiés sans confirmation, et chaque écriture est suivie d'une relecture GAQL pour récapituler les identifiants et les statuts.

L'analyse des performances est ancrée sur l'action de conversion principale confirmée par l'utilisateur — jamais supposée être un achat, un prospect ou une inscription. Les totaux de conversions mixtes de l'interface Google Ads sont signalés comme non fiables tant que l'utilisateur n'a pas confirmé quelles actions sont comptabilisées.

Quatre scripts sont fournis avec la compétence : un assistant client/configuration partagé, un rapport de synthèse des campagnes (diagnostics CTR/ROAS/IS), un rapport de conversions principales au niveau des mots-clés, et un constructeur de campagnes Search en pause à partir d'une spécification JSON. Tous les scripts utilisent le client Python gRPC google-ads.

Les recommandations suivent un processus de travail cohérent : segmenter par groupe d'intention à partir des mots-clés réels de l'utilisateur et du marché, appliquer les actions conserver/observer/réduire/mettre en pause/diviser/ajouter des mots-clés négatifs, et toujours référencer les noms de campagnes et de mots-clés ainsi que les métriques pour faciliter la mise en œuvre.

La compétence fait référence à des modèles GAQL internes et à des mises en garde API afin d'éviter les problèmes connus d'incomplétude REST, en privilégiant le client gRPC. Les lectures de retour après écriture confirment l'identifiant/nom/statut/budget de la campagne, l'identifiant/statut du groupe d'annonces, ainsi que le texte/type de correspondance/statut des mots-clés.

Un nouvel utilisateur connecte son compte Google Ads et la compétence parcourt la liste de contrôle d'intégration — en collectant l'identifiant client, l'authentification, l'action de conversion, les objectifs et les garde-fous — avant d'exécuter report_campaigns.py pour produire un résumé de référence du CTR, du ROAS et de la part d'impressions.

Un annonceur soupçonne que son action de conversion principale est diluée par des micro-conversions dans l'interface. La compétence exécute purchase_keywords.py ciblé sur l'action principale confirmée et met en évidence quels mots-clés génèrent de véritables résultats par rapport aux comptages gonflés.

Le taux de clics de la campagne a chuté et la cause n'est pas claire. La compétence extrait les données relatives aux termes de recherche et aux mots-clés, diagnostique si le problème est lié à la pertinence des annonces, à la dérive des types de correspondance ou à la perte de part d'impressions due au classement, et recommande des actions spécifiques de conservation, de mise en pause, de fractionnement ou d'exclusion, accompagnées de preuves métriques.

Un utilisateur fournit un brief de campagne comprenant les budgets, la stratégie d'enchères, la liste de mots-clés, les types de correspondance, les mots-clés négatifs, les annonces textuelles et les URL. La compétence formate une spec JSON, exécute create_search_skeleton.py en mode simulation en premier, puis crée la structure en état PAUSÉ et relit tous les identifiants et statuts pour confirmation.