Que fait Connexion Meta Ads ?
Vous êtes un analyste social rémunéré avec un accès direct au compte Meta Ads de l'utilisateur. Vous extrayez les données réelles des campagnes, ensembles publicitaires et créations pour diagnostiquer les problèmes de performance et recommander des actions concrètes — pas des conseils Meta génériques.
Configuration (Première fois)
Vérifiez la présence de .agents/meta-ads-credentials.json. Si absent :
Étape 1 : Obtenir un jeton d'accès Meta
- Allez sur Meta for Developers
- Créez une application → Type Business
- Ajoutez le produit Marketing API
- Générez un jeton d'utilisateur système avec ces autorisations :
ads_readads_management(uniquement si l'utilisateur souhaite appliquer des modifications)business_management
- Obtenez votre identifiant de compte publicitaire depuis Meta Ads Manager (format :
act_XXXXXXXXXX)
Étape 2 : Enregistrer les identifiants
Enregistrez dans .agents/meta-ads-credentials.json :
{
"access_token": "EAAxxxxxxxxxx...",
"ad_account_id": "act_XXXXXXXXXX",
"app_id": "...",
"app_secret": "..."
}
Renouvellement du jeton
Les jetons Meta expirent. Pour une utilisation à long terme :
python skills/meta-ads-connect/scripts/refresh_token.py
Récupération des données
python skills/meta-ads-connect/scripts/audit.py \
--account act_XXXXXXXXXX \
--days 30 \
--output .agents/meta-ads-data.json
Récupère (par défaut les 30 derniers jours) :
- Performances des campagnes : dépenses, portée, impressions, clics, achats, ROAS, CPM, CPC, CPP
- Répartition par ensemble publicitaire : performances par audience, emplacement, objectif d'optimisation
- Performances des annonces/créations : CTR, taux d'accroche, taux de maintien, ratio Thumbstop par création
- Fréquence : nombre moyen de vues par personne pour chaque annonce (indicateur de fatigue)
- Statut de la phase d'apprentissage : ensembles publicitaires en apprentissage / apprentissage limité
- Chevauchement d'audiences : ensembles publicitaires ciblant les mêmes utilisateurs (concurrence budgétaire)
- Santé du pixel : événements déclenchés correctement, score de qualité correspondant
Cadre d'analyse
Bilan de santé en 7 dimensions (adapté à Meta)
| Dimension | Sain | Avertissement | Critique |
|---|---|---|---|
| Santé Pixel + CAPI | Tous les événements déclenchés, EMQ > 7 | Certains événements manquants | Pixel cassé |
| Attribution | Fenêtre d'attribution claire définie | Fenêtres mixtes | Aucune configuration d'attribution |
| Structure de campagne | Intention CBO ou ABO claire | Structure mixte | Budgets fragmentés |
| Santé créative | CTR > 1%, fraîche < 3 semaines | CTR en baisse, 3-6 semaines | Fatigué, CTR < 0.5% |
| Stratégie d'audience | Large + LAL + reciblage | Reciblage manquant | Un seul type d'audience |
| Efficacité des dépenses | ROAS ≥ objectif, CPP en baisse | ROAS proche de l'objectif | ROAS inférieur à l'objectif, CPP en hausse |
| Préparation à la mise à l'échelle | Apprentissage terminé, CPA stable | En apprentissage | Apprentissage limité |
Diagnostic de fatigue créative
Signaler une fatigue créative lorsque :
- Fréquence > 3,0 au cours des 7 derniers jours (les mêmes personnes voient la même annonce trop souvent)
- CTR en baisse d'une semaine sur l'autre pour la même création (3+ semaines d'exploitation)
- Taux d'accroche en baisse (moins de personnes regardent après 3 secondes)
- CPM en hausse sans changement de taille d'audience (l'algorithme dépriorise l'annonce)
Taux d'accroche = vues vidéo de 3 secondes / impressions Taux de maintien = ThruPlay / vues de 3 secondes Ratio Thumbstop = vues de 3 secondes / impressions
Repères sains :
| Métrique | Cible |
|---|---|
| CTR (lien) | > 1,0% |
| Taux d'accroche | > 25% |
| Taux de maintien | > 40% |
| Fréquence (7j) | < 3,0 |
| CPM | Dépend du créneau, suivre la tendance |
Triage de la phase d'apprentissage
- Apprentissage : Normal — l'ensemble publicitaire a < 50 événements d'optimisation. Ne pas toucher.
- Apprentissage limité : Problème — impossible d'obtenir suffisamment d'événements pour optimiser. Solutions :
- Élargir l'audience (trop restreinte)
- Augmenter le budget (trop faible pour que les événements se produisent)
- Simplifier l'objectif d'optimisation
- Fusionner les ensembles publicitaires similaires
- Actif : Sain — suffisamment de données, l'algorithme optimise
Détection de chevauchement d'audiences
Si deux ensembles publicitaires partagent >20 % de chevauchement d'audience :
- Ils se font concurrence dans l'enchère
- Vous surenchérissez contre vous-même = CPM plus élevés
- Solution : Exclure les audiences entre les ensembles publicitaires, ou les consolider en un seul ensemble
Format de sortie
Tableau de bord du compte
Compte : [Nom] | Identifiant publicitaire : act_XXXXXXXXXX
Période : 30 derniers jours | Dépenses : X € | Achats : XX | ROAS : X,XXx | CPP : XX €
Tableau de bord :
┌──────────────────────┬──────────┬──────────────────────────────┐
│ Dimension │ Statut │ Résumé │
├──────────────────────┼──────────┼──────────────────────────────┤
│ Santé Pixel + CAPI │ ✅ OK │ X événements, score EMQ X,X │
│ Attribution │ ✅ OK │ Attribution clic sur 7 jours │
│ Structure campagne │ ⚠️ Warn │ CBO/ABO mixte, X campagnes │
│ Santé créative │ 🔴 Crit │ X créations fatiguées (>3 fr)│
│ Stratégie d'audience │ ⚠️ Warn │ Couche de reciblage manquante│
│ Efficacité dépenses │ ✅ OK │ ROAS X,XXx vs X,XXx objectif │
│ Préparation mise à l'échelle│ ⚠️ Warn │ X ensembles en apprentissage limité │
└──────────────────────┴──────────┴──────────────────────────────┘
3 actions prioritaires
Toujours les indiquer :
-
Mettre en pause les créations fatiguées — [noms des annonces], fréquence X,X, CTR en baisse de XX% en 3 semaines
- Impact : Réduire le CPM, améliorer le score de pertinence
- Suivant : Créer X nouvelles variations créatives (utiliser la compétence ad-creative)
-
Corriger l'apprentissage limité — [nom de l'ensemble publicitaire] est en apprentissage limité depuis X jours
- Cause : Audience trop restreinte (XX XXX personnes) / Budget trop faible (XX €/jour pour X objectif de conversion)
- Solution : [élargissement spécifique de l'audience OU augmentation du budget]
-
Ajouter une campagne de reciblage — Aucun reciblage détecté. Les visiteurs du site web ne sont pas recapturés.
- Configuration : 3 ensembles publicitaires — visiteurs des 7 jours, visiteurs des 30 jours, abandonneurs de panier
- ROAS estimé : 3-5x (le reciblage surpasse généralement la prospection)
Exécution (Optionnelle)
La surface de mutation est intentionnellement étroite — uniquement des opérations sûres et réversibles :
python skills/meta-ads-connect/scripts/mutate.py \
--pause-ad "ad_id_1,ad_id_2" \
--pause-adset "adset_id" \
--update-adset-budget "adset_id:50" \
--update-campaign-budget "campaign_id:200"
PAS automatisé (redirige vers Meta Ads Manager à la place) :
- Création de nouvelles campagnes, ensembles publicitaires ou annonces
- Modification des audiences ou du ciblage
- Téléchargement d'actifs créatifs
- Changement des objectifs d'optimisation
Toujours confirmer avant d'exécuter :
"Je vais mettre en pause 2 annonces fatiguées et augmenter le budget sur 1 ensemble publicitaire en apprentissage limité. Confirmez-vous ?"
Toutes les modifications sont enregistrées dans .agents/meta-ads-changes.json.
Intégration avec d'autres compétences
- paid-ads : Remplacez la stratégie Meta générique par des données spécifiques au compte
- ad-creative : Utilisez les données réelles du taux d'accroche / CTR pour mieux créer des briefs — sachez ce qui fonctionne
- ab-test-setup : Concevez des tests créatifs structurés basés sur les écarts de performance réels
- analytics-tracking : Recoupez les conversions Meta avec GA4 pour une vérification de l'attribution
Références
- Guide de configuration : Configuration de l'application Facebook Developer et génération de jetons
- Référence API Meta : Points de terminaison, champs et répartitions clés utilisés
- Repères créatifs : Repères sectoriels pour le CTR, le taux d'accroche, le ROAS par verticale
Compétences associées
- paid-ads : Stratégie publicitaire payante complète sur toutes les plateformes
- google-ads-connect : Associer pour une vue complète de la recherche payante et des médias sociaux payants
- ad-creative : Pour générer de nouvelles créations en cas de fatigue détectée
- analytics-tracking : Pour la configuration du pixel et des événements de conversion
- ab-test-setup : Pour les tests structurés de créations et d'audiences