Documentation
Connect your marketing data to Claude, ChatGPT and other LLMs.
Negatives — lisez les 4 mécanismes, gérez depuis Claude
Google Ads a quatre mécanismes distincts pour les keyword negatives / placements / brand exclusions. La plupart des outils ne montrent qu'un seul. gadspilot lit les quatre dans une vue unifiée + permet à Claude de tous les gérer via des tools MCP dédiés.
Les 4 mécanismes (et pourquoi c'est important)
| Mécanisme | Utilisé par | Comment ajouter (UI) | Comment ajouter (Claude / MCP) |
|---|---|---|---|
| Negatives directs au niveau campagne | Campagnes Search | Campagne → Keywords → Negative keywords | add_negative_keywords(level=CAMPAIGN, ...) |
| Negatives directs au niveau ad-group | Campagnes Search (granulaire) | Ad group → Keywords → Negative keywords | add_negative_keywords(level=AD_GROUP, ...) |
| Shared lists (campaign_shared_set + shared_criterion) | PMax (le seul mécanisme) + Search via shared lists | Tools & Settings → Shared library → Negative keyword lists | shared_set_create + campaign_shared_set_link + shared_set_criterion_add |
| Brand exclusions (campaign_criterion type=BRAND) | PMax (principalement), un peu Search | Campagne → Settings → Brand exclusions | shared_set_create(type=BRANDS) + shared_set_criterion_add |
add_negative_keywords sur une campagne PMax, l'API rejette. Utilisez le workflow shared set à la place (pipeline 4 étapes ci-dessous).Onglet Negatives sur /accounts/{id}/insights
Ouvrez n'importe quelle page insights compte → onglets du bas → Negatives (badge de count montre le total dédupliqué). La table unifiée montre :
- Keyword / Brand — le texte réel
- Match — coloré (vert EXACT, cyan PHRASE, ambre BROAD, rose BRAND)
- Niveau — badge coloré :
- 🔴 BOTH — existe au niveau campagne ET ad-group (le plus impactant)
- 🔵 CAMPAIGN — direct niveau campagne uniquement
- 🟠 AD GROUP — direct niveau ad-group uniquement
- 🟣 SHARED LIST — via une shared list (mécanisme PMax)
- 🩷 BRAND EXCLUSION — brand exclusion (spécifique PMax)
- Source / List — pour les shared lists, montre le nom de la liste (ex : « PMax brand negatives B2B »)
- Campagne + Ad group — contexte
Filtres en haut : All / Both / Campaign / Ad group / Shared list / Brand exclusion + recherche keyword en live.
Pipeline negative PMax en 4 étapes (via Claude)
1. Liste les shared sets existants pour voir si un pertinent existe :
list_shared_sets(type="NEGATIVE_KEYWORDS")
2. Si aucun, en créer un + lier à la campagne PMax :
shared_set_create(name="PMax brand negatives B2B", type="NEGATIVE_KEYWORDS")
campaign_shared_set_link(campaign_id="123", shared_set_id="456")
3. Ajouter les keywords :
shared_set_criterion_add(
shared_set_id="456",
keywords=[
{text: "free", match_type: "BROAD"},
{text: "tutorial", match_type: "PHRASE"}
]
)
4. Vérifier :
list_shared_set_criteria(shared_set_id="456")
Retirer des negatives
Critère unique ou batch — même approche
# 1. Récupérer les criterion_ids de la liste
list_shared_set_criteria(shared_set_id="456")
# retourne [{criterion_id: 789, text: "free", ...}, {criterion_id: 790, text: "tutorial", ...}]
# 2. Retirer un ou plusieurs
shared_set_criterion_remove(
shared_set_id="456",
criterion_ids=["789", "790"]
)
Détacher une shared list d'une campagne sans la supprimer
Utile pour A/B tester l'impact d'une liste d'exclusions :
campaign_shared_set_unlink(campaign_id="123", shared_set_id="456") # Faire tourner la campagne 1 semaine sans shared list, mesurer l'impact, puis re-link si besoin.
Comment l'IA utilise les negatives en contexte
Chaque fois que vous lancez le chat IA in-app sur la page Insights, le système récupère jusqu'à 80 critères negatives (sur les 4 mécanismes) et les injecte dans le prompt sous NEGATIVE_KEYWORDS. L'IA est alors liée par la Règle 5bis du system prompt :
shared_set_criterion_add et pas add_negative_keywords directement. L'IA flagge aussi les negatives trop larges (ex : « free » BROAD bloque des requêtes légitimes « free trial »).FAQ
Pourquoi le même keyword apparaît dans 2 sources ?
Certaines agences maintiennent une « master list » (shared) qui chevauche des negatives directs par campagne. La vue unifiée montre les deux pour que vous nettoyiez la duplication. L'IA flagge ça aussi.
Puis-je bloquer une chaîne YouTube via shared list ?
Oui — utilisez shared_set_create(type=NEGATIVE_PLACEMENTS) puis shared_set_criterion_add avec des placements (URL, ID de chaîne YouTube, etc.). Ou pour des blocs ponctuels sur une campagne spécifique, utilisez add_negative_placements(campaign_id, youtube_channel_ids=[...]) directement.
C'est quoi une brand exclusion vs un negative classique ?
Les brand exclusions excluent une ENTITÉ MARQUE reconnue par Google (une identité de marque normalisée) au lieu d'une string keyword littérale. Utilisé en PMax pour protéger le brand bidding (ne pas s'afficher sur les recherches de marques concurrentes). Créées via shared sets de type BRANDS.
Puis-je voir combien de search terms chaque negative bloque réellement ?
Pas directement — Google n'expose pas ça. Mais vous pouvez lancer le chat IA in-app avec la question « Lequel de mes negatives bloque le plus de volume ? Cross-référence avec les search terms des 30 derniers jours » et l'IA estime depuis les données qu'elle a.
