Écrit le 08/07/2026 par Claude Code, suite à une demande réelle de Raphael (restructurer CAMP-0705-01). Antigravity avait accès à la même API mais n'avait pas de script prêt — ce document comble ça.
Que ce soit CE modèle (Testing Isolé) ou toute autre campagne créée à l'avenir : toute campagne et tous ses ad sets sont créés en PAUSED, sans exception. Peu importe qui la crée (moi ou Claude Code), l'activation réelle attend TOUJOURS une validation explicite de Raphael — jamais d'activation automatique à la création, même si tout semble prêt et correct.
Une fois la campagne créée et validée par Raphael, voici les 3 manipulations possibles — toutes valables aussi bien pour ce modèle Testing Isolé que pour n'importe quelle campagne Meta :
POST /{campaign_id} { status: "ACTIVE" }
POST /{adset_id} { status: "ACTIVE" } <-- pour CHAQUE ad set
POST /{ad_id} { status: "ACTIVE" } <-- pour CHAQUE pub, un par un
⚠️ ERREUR REELLE COMMISE le 08/07/2026, a ne plus refaire : j'avais active la campagne ET les ad sets, mais oublie le 3e niveau (les pubs elles-memes), qui restent PAUSED par defaut depuis leur creation. Resultat : Raphael a vu "Publicite desactivee" dans l'onglet Diffusion malgre campagne+adset actifs. Les TROIS niveaux (campagne, ad set, pub) doivent etre passes a ACTIVE individuellement — aucun raccourci, activer un niveau parent ne fait pas remonter l'activation aux enfants.
Une fois les 3 niveaux actifs, le champ effective_status d'une pub neuve affiche souvent IN_PROCESS (meme en reutilisant un creative deja approuve ailleurs) : c'est normal, chaque nouvel objet "ad" repasse par la verification Meta avant de vraiment diffuser (quelques minutes a quelques heures). Rassurer Raphael que ce n'est pas une erreur si ca arrive.
POST /{campaign_id} { status: "PAUSED" }
Suffit au niveau campagne pour tout arrêter d'un coup (coupe la diffusion de tous les ad sets en dessous, pas besoin de les repasser un par un en PAUSED individuellement pour un arrêt total).
POST /{adset_id} { start_time: "2026-07-08T20:40:00-0400" } <-- format ISO8601 avec fuseau horaire
Le start_time se règle au niveau ad set (pas campagne). Le statut peut rester ACTIVE avec un start_time dans le futur — Meta ne diffusera qu'à partir de cette heure-là. Recommandation : pour un délai très court (quelques minutes), préférer l'activation immédiate plutôt que la programmation — plus simple, moins de risque qu'un déclenchement différé échoue silencieusement sans qu'on le remarque tout de suite.
Sur Meta, le budget se règle au niveau de l'ad set (l'ensemble de publicités), pas au niveau de chaque pub individuelle. Si on met 10 pubs dans 1 seul ad set avec un budget de X€, elles se partagent ce budget — Meta favorise celles qui performent déjà, les autres reçoivent peu ou pas de budget, même si elles ont un packaging "6€" affiché quelque part.
La stratégie "Testing Isolé" (forced spend) consiste à créer 1 ad set par pub — chacun avec son propre budget indépendant. Ça force Meta à donner une vraie chance à chaque pub, sans qu'elles se fassent concurrence entre elles à l'intérieur d'un même budget.
Attention financière à donner à Raphael avant d'exécuter : si on isole N pubs à X€/jour chacune, le budget total quotidien devient N × X€ (ex: 4 pubs × 6€ = 24€/jour). Toujours confirmer explicitement ce montant total avant de créer quoi que ce soit.
GET /{adset_id}?fields=targeting,promoted_object,optimization_goal,billing_event,bid_strategy) — à reprendre à l'identique pour chaque nouvel ad set, sauf instruction contraire.GET /{adset_id}/ads?fields=name,creative{id}) — on réutilise le creative EXISTANT, on ne recrée jamais l'asset (vidéo/texte déjà validés).link_click, pas juste sur le CTR ou les clics totaux qui incluent des réactions/engagement non liés au site).POST /act_{account}/campaigns
name, objective (repris de l'ancienne campagne, ex: OUTCOME_SALES)
status = PAUSED (toujours, jamais ACTIVE directement)
special_ad_categories = []
is_adset_budget_sharing_enabled = false <-- OBLIGATOIRE si pas de budget au niveau campagne,
sinon erreur "Invalid parameter" (code 4834011).
false = isolation totale (aucun partage), exactement
ce que demande la stratégie Testing Isolé.
POST /act_{account}/adsets
name, campaign_id (celui créé à l'étape 1)
daily_budget = montant en CENTIMES (6€ = 600, pas 6)
billing_event, optimization_goal, bid_strategy <-- repris de l'ad set d'origine
targeting = {
"geo_locations": {"countries": ["FR"]},
"publisher_platforms": ["facebook", "instagram"], <-- ⚠️ OBLIGATOIRE ANTI-PIÈGE : EXCLURE AUDIENCE NETWORK !!!
"facebook_positions": ["feed"],
"instagram_positions": ["stream"],
"targeting_automation": {"advantage_audience": 0} <-- OBLIGATOIRE : ciblage manuel, pas d'elargissement auto Meta
} <-- JSON stringifié (NE JAMAIS LAISSER VIDE OU EN AUTOMATIQUE Avantage+, sinon Meta envoie 30%+ du budget sur Audience Network/Jeux Mobiles !)
<-- ⚠️ CORRECTION 25/07/2026 (leçon Ondia, voir mémoire Claude Code
`feedback_ciblage_meta_placements_video_advantage`) : la version precedente de cet
exemple incluait `facebook_reels`, `story`, `marketplace` (Facebook) et `story`, `reels`
(Instagram) en plus du feed. Verifie sur la campagne Ondia (17-25/07/2026) : ces
placements video/engagement generent des clics de tres mauvaise qualite — 558 clics
lien mais seulement 13 vraies visites de page (`landing_page_view`), et 6873 vues
video contre 12 vues produit reelles. Exclure Audience Network ne suffit PAS si les
placements video/Reels/Stories/Marketplace restent actives — c'est le meme phenomene
(clics/engagement sans intention d'achat), juste sur les plateformes officielles au
lieu du reseau tiers. Ne garder QUE le feed (Facebook et Instagram) sauf demande
explicite contraire de Raphael pour un test precis. Idem pour `advantage_audience` :
doit etre explicitement a 0, ne jamais laisser le champ absent en supposant que "pas
de mention" = desactive.
promoted_object = {"pixel_id": "...", "custom_event_type": "PURCHASE"}
status = PAUSED
POST /act_{account}/ads
name, adset_id (celui créé à l'étape 2)
creative = {"creative_id": "..."} <-- l'ID recupere a l'etape prerequis, PAS une recreation
status = PAUSED
Relire GET /{campaign_id}/adsets?fields=name,status,daily_budget,targeting et pour chaque ad set GET /{adset_id}/ads?fields=name,status,creative{id} — confirmer visuellement à Raphael (capture ou tableau texte) : bon nombre d'ad sets, bon budget chacun, bon ciblage, bonne pub attachée. Toujours en PAUSED à ce stade.
Avant l'étape 5 ci-dessous, réponds explicitement à chaque question :
1. Le budget total quotidien réel (N pubs × X€) a-t-il été confirmé explicitement par Raphael, avec le chiffre exact énoncé ?
2. Les 3 niveaux (campagne, ad set, ET chaque pub individuellement) sont-ils bien tous à PAUSED à cet instant — pas seulement les deux premiers ?
3. L'étape 4 (relecture ciblage/budget/pub attachée) a-t-elle été faite et montrée à Raphael, ou est-ce que je m'apprête à passer directement à la suite sans cette vérification ?
Si une seule réponse est Non : ne touche pas à l'ancienne campagne, et ne prépare aucune activation — reviens d'abord compléter le point manquant.
Une fois la nouvelle validée par Raphael : mettre l'ancienne campagne en PAUSED (POST /{old_campaign_id} avec status=PAUSED), puis attendre le feu vert explicite de Raphael avant d'activer la nouvelle (status=ACTIVE sur la campagne ET chaque ad set — les deux niveaux doivent être actifs).
scratch/create_campagne_testing_isole.py (dans le dossier Claude Code) — script complet et testé le 08/07/2026, réutilisable en changeant juste SELECTED_ADS et DAILY_BUDGET_CENTS.
Créer une campagne sans budget campagne ET sans préciser is_adset_budget_sharing_enabled échoue avec une erreur peu claire ("Invalid parameter"). Le vrai message d'erreur utilisateur (error_user_msg) explique le champ manquant — toujours lire ce champ dans la réponse d'erreur Meta, pas juste le code générique.