La Conversions API de Meta (CAPI) est devenue la fondation indispensable de toute stratégie publicitaire sur Facebook et Instagram en 2026. Sans elle, ton Business Manager sous-estime une partie de tes conversions, ton algorithme de bidding fonctionne à l'aveugle, et tu prends des décisions budgétaires basées sur des chiffres faussés.
Ce guide explique précisément ce qu'est CAPI, comment le configurer correctement, comment optimiser le score EMQ qui détermine la qualité de ton matching, et comment éviter les erreurs courantes qui plombent les implémentations naïves.
Qu'est-ce que la Conversions API Meta ?
La Conversions API (CAPI) est une interface serveur-à-serveur qui permet à ton site web ou ton application d'envoyer directement les événements de conversion (achats, leads, ajouts au panier) aux serveurs de Meta, sans passer par le navigateur de l'utilisateur.
Le pixel Meta classique (fbq('track', 'Purchase')) fonctionne dans le navigateur du client. Il dépend des cookies tiers, de l'IDFA sur iOS, et de l'absence de bloqueurs de pub. Avec iOS 14.5 et l'ATT framework, une part importante du signal pixel a disparu.
CAPI contourne ces limitations en envoyant les conversions depuis ton serveur backend (ou un service tiers) directement à l'endpoint https://graph.facebook.com/v22.0/[pixel_id]/events. Les données arrivent à Meta même si :
- L'utilisateur a un bloqueur de pub actif
- L'utilisateur est sur Safari (ITP) ou Firefox (ETP)
- L'utilisateur est sur iOS 14+ sans avoir donné le consentement ATT
- Le pixel client a été bloqué par une CMP avant son chargement
Concrètement, CAPI récupère une grande partie du signal de conversion que le pixel seul ne capte plus. Selon Meta, les annonceurs qui utilisent la Conversions API pour leurs événements web ont en moyenne un coût par résultat inférieur de 17,8 % (source Meta, avril 2026).
Comment CAPI fonctionne techniquement
Le flow d'envoi d'un événement CAPI comprend 5 étapes.
Étape 1 - Capture de l'événement. Quand un utilisateur achète sur ton site, ton backend (ou un service tiers comme DataHide) capte l'événement avec toutes ses données : valeur, devise, ID de produit, ID de transaction, ID de commande.
Étape 2 - Collecte des paramètres utilisateur. Le backend collecte les données qui identifient l'utilisateur : email, téléphone, prénom, nom, code postal, ville, pays, date de naissance. Plus aussi : adresse IP, user-agent, cookies _fbp et _fbc.
Étape 3 - Hashing SHA-256. Toutes les données personnelles (PII) sont hashées en SHA-256 avant envoi, conformément aux exigences Meta et RGPD. Le hash est unidirectionnel : Meta peut comparer hash(email_envoyé) avec hash(email_du_compte_facebook) pour matcher, mais ne peut pas reconstituer l'email original.
Étape 4 - Envoi à Graph API. Le serveur fait un POST HTTPS vers graph.facebook.com/v22.0/[pixel_id]/events avec un access token Meta valide et le payload JSON formaté selon la spec Meta.
Étape 5 - Déduplication avec le pixel. Si le pixel a aussi envoyé le même événement (cas idéal de double tracking), Meta dédoublonne en gardant un seul événement par event_id unique.
Le résultat : Meta reçoit chaque conversion une seule fois, avec le maximum de signal de matching, indépendamment des limitations navigateur.
Setup CAPI étape par étape
Voici la procédure complète pour activer CAPI sur ton compte Meta. Compter 30 à 60 minutes selon ton niveau technique.
Étape 1 - Récupérer ton Pixel ID
Dans Meta Events Manager (business.facebook.com/events_manager), sélectionne ton dataset (anciennement appelé pixel). L'ID est visible en haut de la page, format à 15 chiffres (par exemple 123456789012345).
Si tu n'as pas encore de dataset, crée-le via Events Manager > « Connect data sources » > « Web » > « Conversions API ». Meta te demandera de nommer ton dataset et de le rattacher à un Business Manager.
Étape 2 - Générer un access token CAPI
Dans Events Manager, va dans l'onglet « Settings » de ton dataset, scrolle jusqu'à la section « Conversions API », clique sur « Generate access token ». Meta te donne un token au format EAAxxx... (très long).
Attention sécurité. Ce token donne accès en écriture à ton dataset. Stocke-le dans un secret manager (Vercel env vars, AWS Secrets Manager) et jamais dans le code source ni dans le navigateur. Un token compromis permet à un tiers d'envoyer des faux événements et de polluer ton optimisation Meta.
Étape 3 - Préparer le payload de l'événement
Le payload JSON pour un événement Purchase ressemble à ceci :
{
"data": [
{
"event_name": "Purchase",
"event_time": 1714700000,
"event_id": "evt_abc123_2026-05-02T14:00:00Z",
"action_source": "website",
"event_source_url": "https://datahide.fr/checkout/success",
"user_data": {
"em": ["sha256_hash_email"],
"ph": ["sha256_hash_phone"],
"fn": ["sha256_hash_first_name"],
"ln": ["sha256_hash_last_name"],
"client_ip_address": "203.0.113.42",
"client_user_agent": "Mozilla/5.0 ...",
"fbp": "fb.1.1714700000.1234567890",
"fbc": "fb.1.1714700000.IwAR..."
},
"custom_data": {
"currency": "EUR",
"value": 1497.00
}
}
]
}
Les champs em, ph, fn, ln sont des arrays de hashes SHA-256 hexadécimaux en lowercase.
Étape 4 - Faire l'appel POST
curl -X POST \
"https://graph.facebook.com/v22.0/123456789012345/events?access_token=EAAxxx..." \
-H "Content-Type: application/json" \
-d @payload.json
Meta retourne un objet JSON avec events_received: 1 si tout est OK, ou une erreur explicite (token invalide, payload mal formé, manque de paramètres requis).
Étape 5 - Vérifier dans Events Manager
Dans Events Manager > onglet « Test events », tu peux voir en temps réel les événements reçus, leur source (Pixel, CAPI, ou les deux), et le score EMQ associé.
Délai d'apparition. Compter 5 à 30 minutes pour qu'un événement CAPI apparaisse dans Test events. Pour qu'il influence l'algorithme d'optimisation des campagnes, il faut attendre 24 à 72 heures.
Event Match Quality (EMQ) : l'indicateur critique
Meta a introduit en 2021 un score de 0 à 10 appelé Event Match Quality qui mesure la qualité du matching entre les événements que tu envoies et les utilisateurs Facebook réels.
| Score EMQ | Niveau | Interprétation |
|---|---|---|
| 0 - 3 | Critique | Algo fonctionne à l'aveugle, ROAS reporté faussé |
| 4 - 5 | Mauvais | Optimisation sous-performante, une part importante du signal perdue |
| 6 - 7 | Acceptable | Performance correcte, marge d'amélioration |
| 8 - 9 | Bon | Algorithme bien informé, ROAS représentatif |
| 10 | Parfait | Tous les signaux possibles envoyés et matchés |
L'EMQ est calculé par événement (Lead, AddToCart, Purchase) et par dataset. Tu le retrouves dans Events Manager > onglet « Diagnostics » > section « Quality of customer information parameters ».
Comment maximiser ton EMQ
L'EMQ dépend du nombre de paramètres utilisateur que tu envoies et de leur qualité. Voici la liste classée par poids dans le matching :
| Paramètre | Code | Poids matching | Source |
|---|---|---|---|
em | Très fort | Formulaire client | |
| Téléphone | ph | Très fort | Formulaire client |
| External ID | external_id | Fort | ID interne (CRM, BDD) |
| Cookie fbp | fbp | Fort | Pixel Meta |
| Click ID fbc | fbc | Fort | URL paramètre fbclid |
| Prénom + Nom | fn, ln | Moyen | Formulaire client |
| Code postal + Pays | zp, country | Moyen | Formulaire client |
| IP + User-agent | client_ip_address, client_user_agent | Faible | Requête HTTP |
| Date de naissance | db | Faible (souvent absente) | Formulaire client |
Règle d'or. Envoie systématiquement email + téléphone hashés + IP + user-agent + fbp + fbc à chaque événement. C'est le minimum pour atteindre EMQ 8+.
Ordres de grandeur indicatifs :
- Email seul : EMQ 4 à 5
- Email + téléphone : EMQ 6 à 7
- Email + téléphone + IP/UA + fbp : EMQ 7 à 8
- Email + téléphone + IP/UA + fbp + fbc + nom : EMQ 8 à 9
- Tous les champs ci-dessus + external_id : EMQ 9 à 10
Déduplication pixel + CAPI : la règle absolue
L'erreur N°1 que je vois sur les implémentations CAPI maison : envoyer CAPI sans déduplication avec le pixel client. Résultat : chaque conversion est comptée 2 fois, ton ROAS reporté est artificiellement gonflé, et l'algorithme de Meta finit par te pénaliser quand il détecte les doublons.
La solution : toujours envoyer un event_id unique au pixel ET à CAPI pour le même événement.
Côté pixel client :
const eventId = "evt_" + crypto.randomUUID();
fbq('track', 'Purchase', {
value: 1497,
currency: 'EUR'
}, {
eventID: eventId
});
// Envoyer le même eventId au backend pour CAPI
fetch('/api/track', {
method: 'POST',
body: JSON.stringify({ event: 'Purchase', eventId, value: 1497 })
});
Côté backend CAPI :
const payload = {
event_name: "Purchase",
event_id: eventId, // MÊME event_id que le pixel
event_time: Math.floor(Date.now() / 1000),
// ... reste du payload
};
Meta dédoublonne automatiquement en gardant un seul événement par event_id. Si seul le pixel a réussi à passer (cas optimiste), il compte. Si seul CAPI a réussi (cas où le pixel est bloqué), il compte. Si les deux passent, un seul est gardé. Aucun double comptage.
Erreurs courantes à éviter
Erreur 1 - Hashing incorrect. Le hash SHA-256 doit être calculé sur la valeur normalisée : email en lowercase et trimmed, téléphone en chiffres seuls avec l'indicatif pays (33612345678 : ni +, ni espace, ni 0 initial), prénom/nom en lowercase. Une erreur de normalisation = matching à 0.
Erreur 2 - Envoyer les données en clair. Meta refuse les events avec des PII non hashées. Erreur API explicite : "User data must be hashed". Vérifier que toutes les valeurs em, ph, fn, ln, zp, db sont des hashes hexadécimaux 64 caractères.
Erreur 3 - Oublier action_source. Ce champ obligatoire indique d'où vient l'événement : website, email, app, phone_call, chat, physical_store, system_generated, business_messaging. Sans, Meta retourne une erreur ou ignore l'événement.
Erreur 4 - Timestamp en millisecondes. event_time doit être un timestamp Unix en secondes (10 chiffres), pas en millisecondes (13 chiffres). Erreur fréquente avec Date.now() qui retourne des millisecondes par défaut. Diviser par 1000 et arrondir.
Erreur 5 - Pas de retry sur les erreurs réseau. L'API Meta peut retourner des erreurs 5xx temporaires. Sans retry, tu perds ces événements. Implémenter un retry avec backoff exponentiel (3 tentatives, espacement 1s, 5s, 30s).
Erreur 6 - Token expiré. L'access token CAPI peut expirer si tu n'as pas configuré un Business Integration System User. Ton implémentation doit logger les erreurs 401 explicitement et alerter pour régénérer le token.
Implémenter CAPI : 3 approches
Approche 1 - Code maison. Tu codes l'envoi vers graph.facebook.com depuis ton backend, gères le hashing, la déduplication, les retries, le monitoring EMQ. Tech stack typique : Node.js / Python / PHP avec librairie HTTP. Compter 3 à 7 jours de dev senior pour une implémentation production-ready, plus la maintenance permanente quand l'API Meta évolue (versions Graph, nouveaux paramètres, changements de format).
Approche 2 - Server-Side Tag Manager (Google). Tu déploies un container GTM serveur (sur Google Cloud Run, AWS, ou hébergement dédié), tu configures le tag Meta CAPI fourni par Meta. Pro : flexibilité, multi-plateformes (Meta + Google + TikTok dans un seul GTM). Con : hébergement à 100-300 EUR/mois, configuration GTM serveur complexe, monitoring à faire séparément.
Approche 3 - Outil dédié (DataHide, Hyros, TripleWhale). Tu installes un script léger sur ton site, connectes ton dataset Meta via OAuth, et l'outil gère tout : envoi pixel + CAPI dédoublonné, hashing, monitoring EMQ, retries automatiques, mise à jour des versions Graph API. Chez DataHide, le setup prend 10 minutes, en visio avec le fondateur. Voir notre comparatif détaillé Hyros vs DataHide pour le choix entre outils.
Pour la plupart des infopreneurs sans équipe dev dédiée, l'approche 3 est la plus pragmatique. Le coût mensuel d'un outil (de 249 € à 2 990 € HT par mois pour DataHide, selon ton budget pub) est inférieur au coût caché d'une implémentation maison qui se dégrade silencieusement.
Exemple : remonter l'EMQ en deux semaines
Prenons un exemple illustratif : un coach business qui investit chaque mois sur Meta, avec un Business Manager qui affiche un ROAS reporté très en dessous de ses ventes réelles. Aucune implémentation CAPI : pixel client uniquement, et à moitié bloqué par sa CMP.
Semaine 1 - Setup initial.
- Activation de CAPI via DataHide (setup de 10 minutes en visio : connexion Meta + script pixel)
- Envoi pixel + CAPI avec un event_id unique pour la déduplication
- Hashing SHA-256 automatique de l'email et du téléphone
- Relevé de l'EMQ de départ sur Lead et sur Purchase
Semaine 2 - Optimisation des paramètres.
- Ajout de
external_id(ID du contact dans le CRM) dans le payload - Capture systématique de l'IP et du user-agent côté serveur
- Récupération du cookie
_fbpet dufbc(depuis le paramètre d'URL fbclid) - Nouveau relevé de l'EMQ
Ce qu'il faut regarder à J+30 :
- les conversions reçues par Meta se rapprochent des ventes réelles ;
- le ROAS reporté se réaligne sur ce que Stripe encaisse ;
- la décision sur Meta (couper ou scaler) repose enfin sur des ventes réelles, et plus sur la moitié du signal.
Questions fréquentes
CAPI est-il obligatoire ou juste recommandé ?
Techniquement, le pixel client seul fonctionne encore. En pratique, sans CAPI tu perds une partie du signal en 2026, ton ROAS reporté est faussé, et l'algorithme Meta optimise sur des données incomplètes. Aucune équipe média sérieuse en France ne se passe de CAPI aujourd'hui.
Faut-il garder le pixel client si on a CAPI ?
Oui, absolument. Meta recommande explicitement le combo pixel + CAPI avec dédup. Le pixel capte les utilisateurs sans bloqueur en temps réel, fournit le cookie _fbp (impossible à générer côté serveur), et continue de fonctionner même si ton serveur backend a un downtime.
CAPI est-il conforme RGPD ?
CAPI permet une implémentation conforme RGPD si tu respectes 3 conditions : obtenir le consentement utilisateur via une CMP avant tout envoi, hasher les PII en SHA-256 avant transmission, signer un DPA avec Meta (disponible via Business Settings).
Comment gérer CAPI avec une CMP type Axeptio ou Didomi ?
La CMP doit envoyer un signal de consentement à ton backend (cookie ou paramètre URL). Ton backend ne déclenche l'envoi CAPI que si le consentement marketing est OK. Sans consentement, ni le pixel ni CAPI ne firent. La logique est identique au pixel client classique, simplement appliquée côté serveur.
Quel volume de pub minimum pour que CAPI soit rentable ?
CAPI a une valeur dès le premier euro de pub. La précision du tracking améliore les décisions à tous les volumes. Le coût d'un outil dédié (de 249 € à 2 990 € HT par mois chez DataHide, selon le budget pub) pèse de moins en moins lourd à mesure que le budget monte. Sur un petit budget, il représente une part plus grande, mais la précision reste utile.
Combien de temps pour voir l'impact CAPI sur le ROAS ?
L'EMQ s'améliore en 24 à 72h après l'envoi des premiers événements bien matchés. L'algorithme Meta intègre le nouveau signal et réoptimise les enchères en 7 à 14 jours. Le ROAS reporté se réaligne avec la réalité Stripe en 14 à 30 jours selon le volume de conversions.
Quels événements envoyer en priorité via CAPI ?
L'événement Purchase est de loin le plus important (signal d'optimisation principal). Ensuite : InitiateCheckout, AddPaymentInfo, Lead. Pour les funnels à entonnoir long, ajouter ViewContent et AddToCart. Pour les SaaS B2B : CompleteRegistration, StartTrial, Subscribe.
Récap : pourquoi CAPI est la priorité numéro 1 en 2026
CAPI n'est plus une option en 2026, c'est la fondation indispensable de toute publicité Meta. Sans CAPI, tu travailles avec un signal incomplet et tu prends des décisions à l'aveugle. Avec CAPI bien configuré (EMQ 8+), tu retrouves la précision qu'on avait avant iOS 14, voire mieux.
L'investissement initial (10 minutes de setup en visio avec DataHide, ou plusieurs jours de dev avec une approche maison) est ridiculement faible, comparé à ce qu'il apporte à tes décisions.
Si tu fais de la pub Meta chaque mois et que tu n'as pas encore CAPI configuré avec un EMQ supérieur à 7, c'est probablement le projet le plus rentable que tu peux lancer cette semaine.
Tu peux tester DataHide gratuitement pendant 14 jours et voir ton EMQ réel sur tes événements, après un setup de 10 minutes.