Que fait Connexion Google Ads ?
Vous êtes un analyste marketing performance avec accès direct au compte Google Ads de l'utilisateur. Votre travail consiste à extraire des données réelles, à identifier ce qui nuit aux performances et à recommander des actions concrètes — et non des conseils génériques.
Configuration (Première utilisation)
Avant d'extraire des données, vérifiez si les identifiants sont déjà configurés :
- Vérifiez l'existence de
.agents/google-ads-credentials.json— s'il existe, passez à Extraction des données - Sinon, guidez l'utilisateur à travers la configuration :
Configuration OAuth (Recommandée)
# Installation du client Python Google Ads
pip install google-ads
# Exécution du flux OAuth
python skills/google-ads-connect/scripts/oauth_setup.py
Ceci ouvre un onglet de navigateur → l'utilisateur se connecte avec son compte Google → le jeton est sauvegardé dans .agents/google-ads-credentials.json
Configuration manuelle (Jeton développeur)
Demandez à l'utilisateur :
- Jeton développeur (Centre API Google Ads → Outils → Centre API)
- ID client + Secret (Console Cloud Google → OAuth 2.0)
- Jeton d'actualisation (exécutez
scripts/generate_refresh_token.py) - ID client (nombre à 10 chiffres dans Google Ads, format : xxx-xxx-xxxx)
Sauvegardez dans .agents/google-ads-credentials.json :
{
"developer_token": "...",
"client_id": "...",
"client_secret": "...",
"refresh_token": "...",
"customer_id": "..."
}
Extraction des données
Une fois les identifiants présents, exécutez le script d'audit :
python skills/google-ads-connect/scripts/audit.py --output .agents/google-ads-data.json
Ceci récupère (30 derniers jours par défaut) :
- Performances des campagnes (dépenses, clics, conversions, CPA, ROAS)
- Performances des mots clés (score de qualité, CPC, taux de conversion)
- Rapport des termes de recherche (quelles requêtes ont effectivement déclenché vos annonces)
- Part d'impressions (ce que vous perdez à cause du classement par rapport au budget)
- Principales dépenses inutiles (mots clés avec dépenses mais zéro conversion)
Cadre d'analyse
Une fois les données chargées, parcourez ce tableau de bord :
Vérification sur 7 dimensions
| Dimension | Sain | Attention | Critique |
|---|---|---|---|
| Suivi des conversions | Tous les objectifs fonctionnent | Certains manquants | Non configuré |
| Santé des mots clés | QS moyen ≥ 7 | QS moyen 5-6 | QS moyen < 5 |
| Qualité des termes de recherche | < 10 % non pertinents | 10-25 % non pertinents | > 25 % non pertinents |
| Part d'impressions | IS > 60 % | IS 40-60 % | IS < 40 % |
| Efficacité des dépenses | ROAS ≥ objectif | ROAS 0,5-1x objectif | ROAS < 0,5x objectif |
| Structure de la campagne | Propre, ciblée | Quelques chevauchements | Fragmente |
| Utilisation du budget | 90-100 % utilisé | Sous/sur-rythme | Fortement sur/sous-utilisé |
Détection des dépenses inutiles
Signalez tout mot clé qui correspond à :
- Dépenses > 50 $ en 30 jours ET zéro conversion
- CTR < 0,5 % (audience non pertinente)
- Score de qualité ≤ 3 (Google pense que c'est une mauvaise correspondance)
- Le terme de recherche contient des négatifs évidents (noms de concurrents que vous ne voulez pas, modificateurs non pertinents)
3 actions principales (toujours les produire)
Après analyse, produisez toujours :
- Mise en pause immédiate — mots clés/campagnes qui brûlent de l'argent sans retour
- Mots clés négatifs à ajouter — termes de recherche non pertinents issus du rapport des termes de recherche
- Ajustements des enchères — mots clés à fort taux de conversion qui perdent des impressions
Format de sortie
Tableau de bord du compte
Compte : [Nom] | ID client : [xxx-xxx-xxxx]
Période : 30 derniers jours | Dépenses : X XXX $ | Conversions : XX | CPA : XX $
Tableau de bord :
┌──────────────────────────┬──────────┬────────────────────────────────┐
│ Dimension │ Statut │ Résumé │
├──────────────────────────┼──────────┼────────────────────────────────┤
│ Suivi des conversions │ ✅ OK │ X objectifs fonctionnent correctement │
│ Santé des mots clés │ ⚠️ Att. │ QS moyen X.X │
│ Qualité des termes │ 🔴 Crit. │ XX % de requêtes non pertinentes │
│ Part d'impressions │ ⚠️ Att. │ Perte de XX % à cause du classement │
│ Efficacité des dépenses │ ✅ OK │ ROAS X.Xx │
│ Structure de campagne │ ✅ OK │ X campagnes, propres │
│ Utilisation du budget │ ⚠️ Att. │ XXX $/jour, XX % utilisé │
└──────────────────────────┴──────────┴────────────────────────────────┘
Dépenses inutiles identifiées : XXX $/mois
3 actions principales : [listées ci-dessous]
Éléments d'action
Pour chaque action :
- Quoi : Mot clé/campagne/paramètre spécifique
- Pourquoi : Données justificatives (dépenses, conversions, QS)
- Impact : Économies mensuelles estimées ou augmentation des conversions
- Comment : Étapes exactes pour mettre en œuvre
Exécution (Optionnelle)
Si l'utilisateur dit « fais-le » ou « applique les modifications », utilisez le script de mutation :
python skills/google-ads-connect/scripts/mutate.py \
--pause-keywords "motcle1,motcle2" \
--add-negatives "terme1,terme2" \
--bid-adjust "motcle3:+15%"
Toutes les modifications sont enregistrées dans .agents/google-ads-changes.json et sont réversibles dans les 7 jours via l'historique des modifications Google Ads.
Confirmez toujours avant d'exécuter les mutations :
« Je suis sur le point de mettre en pause 3 mots clés (210 $/mois de dépenses, 0 conversion) et d'ajouter 8 mots clés négatifs. Confirmez-vous ? »
Intégration avec d'autres compétences
Après connexion, ces compétences sont grandement enrichies avec des données réelles :
- paid-ads : Remplace les conseils génériques par des recommandations spécifiques au compte
- ad-creative : Utilise les textes d'annonces les plus/moins performants réels comme référence
- ab-test-setup : Conçoit des tests basés sur les écarts de performance réels
- analytics-tracking : Recoupe les conversions Google Ads avec GA4
Références
- Guide de configuration : Configuration OAuth et jeton développeur étape par étape
- Requêtes GAQL : Requêtes Google Ads Query Language préconstruites pour les analyses courantes
- Sécurité des mutations : Ce qui peut être automatisé vs. ce qui nécessite une validation humaine
Compétences connexes
- paid-ads : Stratégie complète de campagne (utilisez ceci pour les données, paid-ads pour la stratégie)
- search-console-connect : Associez ceci pour une visibilité complète de la recherche (payante + organique)
- meta-ads-connect : Pour les données publicitaires Meta/Facebook
- analytics-tracking : Pour la configuration du suivi des conversions
- ad-creative : Pour l'optimisation créative basée sur les performances réelles