Généré le 14/10/2026 22:43

SOP : Restructurer une campagne Meta en "Testing Isolé" (1 ad set = 1 pub)

É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.

🔒 RÈGLE ABSOLUE (validée avec Raphael le 08/07/2026, ne jamais déroger)

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.

Activer / Désactiver / Programmer une campagne (les 3 actions courantes après création)

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 :

Activer immédiatement (le plus simple et le plus prévisible)

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.

Désactiver / remettre en pause

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).

Programmer un démarrage différé (au lieu d'activer immédiatement)

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.

Le principe (à expliquer à Raphael si besoin)

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.

Prérequis à récupérer avant de coder

  1. Le ciblage exact de la campagne existante (via GET /{adset_id}?fields=targeting,promoted_object,optimization_goal,billing_event,bid_strategy) — à reprendre à l'identique pour chaque nouvel ad set, sauf instruction contraire.
  2. Le creative_id de chaque pub à isoler (via 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).
  3. La sélection des pubs à isoler : toujours demander a Raphael quelles pubs précisément (se baser sur link_click, pas juste sur le CTR ou les clics totaux qui incluent des réactions/engagement non liés au site).

Étapes API (dans cet ordre)

1. Créer la nouvelle campagne

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é.

2. Pour chaque pub à isoler : un ad set dédié

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

3. Pour chaque ad set : une seule pub, réutilisant le creative existant

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

4. Vérification (ne jamais sauter cette étape)

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.

☑️ CHECKLIST D'AUTO-VALIDATION — AVANT LE SORT DE L'ANCIENNE CAMPAGNE (ajoutée 09/07/2026)

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.

5. Sort de l'ancienne campagne

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).

Script de référence

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.

Piège rencontré une fois (à ne pas re-découvrir)

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.