Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
Account Targets — donnez à votre IA un objectif de comparaison
Définissez des cibles CPA / ROAS / plafond de budget mensuel par compte Google Ads ou par campagne individuelle. L'IA les utilise dans chaque audit, réponse de chat, et proposition d'action write — finies les réponses génériques « votre ROAS est de 1,8 », à la place « votre ROAS est de 1,8 vs votre cible de 2,5 = 28 % en dessous, top 3 campagnes contribuant : X / Y / Z ».
Où les définir
Deux niveaux — defaults compte + overrides par campagne.
Cibles au niveau compte (defaults)
- Allez sur
/accounts/{id}/targets(ou cliquez sur « Targets » sur la carte du compte) - Section du haut — renseignez 3 champs :
- Cible CPA (€) — le coût par conversion visé. Laissez vide si vous optimisez seulement pour le ROAS
- Cible ROAS (x) — return on ad spend (revenue / cost). Laissez vide si vous ne trackez pas la valeur de conversion
- Plafond de budget mensuel (€) — plafond dur sur le total de spend par mois. L'IA prévient avant tout write qui le ferait dépasser
- Cliquez sur Save — ces valeurs deviennent les defaults pour chaque campagne sans override explicite
Overrides par campagne
Même page, table en dessous. Chaque ligne campagne montre :
- Nom de la campagne + statut + performance actuelle (CPA / ROAS / spend des 30 derniers jours)
- Deux cellules éditables : Override CPA + Override ROAS
- Vide / 0 = hérite du default compte
Édition en lot supportée : changez plusieurs lignes, cliquez sur Save targets en bas — sauve tout en une seule batch.
Comment l'IA utilise les cibles
| Où | Ce qui change |
|---|---|
| Chat AI Insights (page Ads) | Chaque réponse contextualise les chiffres vs cibles (« CPA 42 € — c'est 68 % au-dessus de votre cible de 25 € ») |
| Indicateurs de santé sur les cards | Les campagnes affichées ✅ bonnes / ⚠ warning / ❌ mauvaises utilisent vos cibles, pas une heuristique générique 2x ROAS |
| Propositions d'action write via MCP | Avant tout update_campaign_budget / pause_ad, Claude récupère vos cibles pour justifier le changement |
| Synthèse SEO Audit | La section « Top 3 priorities » pondère les opportunités liées à Ads selon votre écart de CPA — plus l'écart est grand, plus la priorité est haute |
| Mémoire persistante | Les cibles sont auto-injectées dans le system prompt de chaque session MCP, donc Claude les connaît sans re-discovery |
Exemples de workflows
Check matinal quotidien
Quelles campagnes sont sous-performantes par rapport à la cible cette semaine ? Utilise mes cibles CPA + ROAS, trie par € perdus = (CPA réel - CPA cible) × conversions. Top 5.
Pacing budget mensuel
On est à J+18 du mois. Avec le rythme de spend actuel, va-t-on dépasser le plafond de budget mensuel sur l'un des comptes ? Liste les comptes à risque + le dépassement projeté en €.
Re-tuning des campagnes brand
Mes campagnes brand ont un override CPA à 30 € (vs 15 € de default compte). Respectent-elles encore cette cible large ? Si certaines dépassent 30 €, de combien ?
Limites
| Quoi | Limite |
|---|---|
| CPA cible max | 100 000 € |
| ROAS cible max | 99,99x |
| Plafond de budget mensuel max | 10 000 000 € |
| Nombre d'overrides par campagne | Illimité |
FAQ
Les cibles sont-elles poussées vers Google Ads ?
Non — les cibles sont stockées localement dans gadspilot et utilisées uniquement par l'IA pour la contextualisation. Elles ne sont PAS poussées vers Google Ads (i.e. elles ne changent pas votre stratégie d'enchères ou vos budgets quotidiens réels). Pour ça, utilisez explicitement le tool MCP write update_campaign_budget ou update_bidding_strategy.
Search/Display : update_bidding_strategy(bidding_strategy=TARGET_CPA, target_cpa_micros=25000000) pour une cible CPA de 25 €.
Performance Max : l'API rejette TARGET_CPA / TARGET_ROAS comme stratégies directes — utilisez le pattern « Maximize conversions with target CPA » à la place : update_bidding_strategy(bidding_strategy=MAXIMIZE_CONVERSIONS, target_cpa_micros=25000000). Même idée pour ROAS via MAXIMIZE_CONVERSION_VALUE + target_roas. Voir le deep dive PMax pour la justification complète.
Pourquoi stocker le plafond budget dans gadspilot si Google Ads a ses propres budgets quotidiens ?
Les budgets quotidiens de Google empêchent les dépassements intra-journée mais ne forcent pas un plafond mensuel. Vous pourriez avoir 20 campagnes actives à 100 €/jour = 60 k€/mois sans aucun avertissement jusqu'à ce que la carte bancaire crie. Le plafond mensuel gadspilot est un système d'alerte précoce que l'IA vérifie de manière proactive.
Puis-je importer des cibles en masse depuis un CSV ?
Pas encore via l'UI — mais vous pouvez utiliser les tools MCP write depuis Claude. Demandez : « Je vais coller un CSV de campaign_id;target_cpa;target_roas. Définis-les tous. »
Que se passe-t-il si une campagne n'a pas de cible ni de default compte ?
L'IA fallback sur des defaults industrie (CPA = un « bon » CPA par type de canal, ROAS = 2,0 minimum). Elle le dira explicitement dans les réponses (« pas de cible définie, comparaison avec une baseline industrie de... »).
