Qu'est-ce que l'API Conversions de Meta (CAPI) ? Le guide clair pour les annonceurs
Si vous faites de la publicité sur Meta, quelqu'un vous a sûrement déjà conseillé de « mettre en place la CAPI ». En général juste après que vous vous êtes plaint que le Gestionnaire de publicités affiche 12 achats alors que votre boutique en compte 31.
Le conseil est bon. Mais la plupart des explications sur l'API Conversions sont écrites soit pour des développeurs, soit par quelqu'un qui veut vous vendre quelque chose sans vraiment l'expliquer. Ce guide s'adresse aux annonceurs et aux chefs d'entreprise qui veulent comprendre ce qu'elle fait avant de toucher à quoi que ce soit.
L'API Conversions en un paragraphe
L'API Conversions de Meta (Conversions API ou CAPI) permet d'envoyer des événements de conversion — leads, inscriptions, achats — à Meta depuis votre serveur, votre CRM ou votre back-end, plutôt que depuis le navigateur du visiteur. Le pixel Meta observe ce qui se passe sur une page. L'API Conversions rapporte ce qui se passe dans votre entreprise. Quand les deux fonctionnent ensemble, Meta obtient une image plus complète et plus fiable de qui a converti après avoir vu vos publicités, et s'en sert pour décider à qui les montrer ensuite.
Pourquoi le pixel seul ne suffit plus
Le pixel est un morceau de JavaScript. Il ne fonctionne que s'il se charge, s'exécute et a le droit d'envoyer des données. Aujourd'hui, beaucoup de choses l'en empêchent :
- Les bloqueurs de publicité et les navigateurs axés sur la confidentialité bloquent purement et simplement les requêtes vers les domaines de Facebook.
- Les restrictions de suivi d'iOS et la durée de vie réduite des cookies dans Safari coupent le lien entre le clic sur la publicité et une conversion qui a lieu quelques jours plus tard.
- Souvent, la conversion n'a même pas lieu sur le site. Quelqu'un remplit un formulaire, et votre commercial conclut la vente par téléphone une semaine plus tard. Le pixel ne voit jamais cette vente.
- Pages lentes et départs précoces. Si la personne ferme la page de remerciement avant que le pixel se déclenche, l'événement est perdu.
Ce sont les deux derniers points qu'on sous-estime le plus. Dans la génération de leads — cliniques, immobilier, formation, voyage, services B2B —, l'événement qui compte (une vente payée) se trouve dans le CRM, pas sur une page web. Le pixel ne peut tout simplement pas le remonter. L'API Conversions, si.
À quoi sert l'API Conversions de Meta
Meta présente l'objectif comme une connexion plus fiable entre les données marketing et les résultats publicitaires. Concrètement, cela se résume à trois choses :
- Une meilleure mesure. Davantage de conversions réelles apparaissent dans le Gestionnaire de publicités, et votre coût par résultat se rapproche de la réalité.
- Une meilleure optimisation. Le système de diffusion de Meta apprend à partir des conversions. S'il n'en voit que la moitié, il apprend sur un échantillon biaisé. En lui transmettant de vraies ventes — et pas seulement des formulaires remplis —, vous lui apprenez à trouver les gens qui achètent vraiment.
- Moins de dépendance au navigateur. Vos données ne se perdent plus à chaque fois qu'un éditeur de navigateur change ses règles.
Comment ça marche, étape par étape
Voici ce qui se passe dans une configuration classique de génération de leads :
- Une personne clique sur votre publicité. Meta ajoute un identifiant de clic (
fbclid) à l'URL de la page de destination, et le pixel l'enregistre dans le cookie_fbc. - Elle envoie un formulaire. Votre site, votre CRM ou votre intégration enregistre ses coordonnées avec cet identifiant de clic.
- Quand quelque chose d'important se produit — le lead est créé, qualifié ou paie —, votre serveur envoie un événement à Meta : le nom de l'événement, l'heure et des données client comme l'e-mail et le téléphone.
- Les données personnelles sont hachées (SHA-256) avant de quitter votre serveur. Meta compare ces empreintes avec ses propres utilisateurs et attribue la conversion à la publicité que cette personne a vue.
La capacité de Meta à relier vos événements à des personnes réelles s'appelle la qualité de la correspondance des événements (Event Match Quality, EMQ), notée de 0 à 10 dans le Gestionnaire d'événements. Seuls les événements associés servent à l'attribution et à l'optimisation des publicités ; les autres comptent uniquement pour la mesure de base. Plus vous envoyez d'identifiants — e-mail, téléphone, nom, adresse IP, user agent, fbc, fbp, external_id —, plus la note est généralement élevée.
API Conversions ou pixel Meta : faut-il les deux ?
Oui, dans la plupart des cas. Ils ne sont pas concurrents. Meta recommande de les utiliser ensemble, pour une raison simple : chacun voit ce que l'autre ne voit pas.
| Pixel Meta | API Conversions | |
|---|---|---|
| Où il fonctionne | Dans le navigateur du visiteur | Sur votre serveur, votre CRM ou une intégration |
| Bloqué par les bloqueurs de publicité | Souvent | Non |
| Voit les ventes hors ligne et les étapes du CRM | Non | Oui |
| Voit le comportement sur la page (vues, défilement, panier) | Oui | Seulement ce que vous envoyez |
| Mise en place | Coller un extrait de code | Code serveur, une passerelle ou une intégration prête à l'emploi |
Quand le même événement arrive par les deux canaux, Meta doit comprendre qu'il s'agit d'un seul événement et non de deux. C'est la déduplication : les deux copies doivent avoir le même event_name et le même event_id (ou des external_id et fbp identiques). Si c'est mal fait, vos achats sont comptés en double dans le Gestionnaire de publicités — une erreur très fréquente dans les configurations maison. Nous y reviendrons en détail dans un article dédié à l'API Conversions face au pixel.
Les limites à connaître avant de commencer
- La règle des 7 jours. Le
event_timed'un événement peut remonter à 7 jours au maximum au moment de l'envoi. Si un seul événement du lot est plus ancien, Meta rejette toute la requête. C'est important si vous voulez remonter des ventes conclues des semaines après l'arrivée du lead : il faut les envoyer dès que l'étape change, pas dans un export mensuel. - Les ventes en magasin doivent être importées dans les 62 jours suivant la conversion, mais chaque événement doit tout de même respecter la limite de 7 jours du
event_timeau moment de l'envoi. - Le hachage est obligatoire pour les données personnelles. Les e-mails ou numéros de téléphone en clair ne doivent pas quitter votre serveur.
- Envoyez presque en temps réel. Meta recommande un envoi en temps réel ou par lots proches du temps réel. Des lots quotidiens fonctionnent, mais l'optimisation réagit plus vite à des données fraîches.
- La CAPI ne sert pas qu'aux sites web. Les événements peuvent venir d'un site, d'un appel, d'un chat, d'un magasin, d'un e-mail ou d'une messagerie professionnelle — le champ
action_sourceindique à Meta où la conversion a eu lieu.
Trois façons de mettre en place l'API Conversions
1. Intégration directe (avec un développeur)
Votre développeur écrit le code qui appelle l'API Conversions, gère le hachage, les nouvelles tentatives et la déduplication, et conserve en sécurité un jeton d'accès d'utilisateur système. Flexibilité maximale, mais c'est un vrai travail de développement — et quelqu'un doit le maintenir quand Meta change de version d'API.
2. Conversions API Gateway
La solution en libre-service de Meta. Vous déployez une passerelle dans votre propre compte cloud (AWS ou Google Cloud), vous y connectez votre pixel, et elle réplique les événements du navigateur côté serveur. Meta ne facture pas de licence, mais vous payez les ressources cloud. Le hic : elle est conçue pour les événements du site web. Elle ne sait pas quand une vente est conclue dans votre CRM.
3. Une intégration prête à l'emploi
Des plateformes comme Shopify intègrent déjà la CAPI pour l'e-commerce. Pour la génération de leads, le trou a toujours été le CRM : la vente se fait dans HubSpot, Pipedrive ou une feuille Google Sheets, et rien ne la transmet à Meta.
C'est pour combler ce trou que LeadMe a été créé. Vous connectez votre pixel Meta et votre source — un CRM, un formulaire, un tableur —, vous choisissez quelles étapes du pipeline deviennent quels événements (Lead, lead qualifié, achat), et LeadMe les envoie via l'API Conversions, avec le hachage, la déduplication et les identifiants de clic gérés automatiquement. Pas de serveur à louer, pas de code. Il fonctionne aussi avec TikTok, Google Ads et d'autres plateformes, pour que les mêmes données CRM alimentent tous vos canaux publicitaires.
Comment vérifier que ça fonctionne
- Dans le Gestionnaire d'événements → Tester les événements, envoyez un événement test et vérifiez qu'il arrive avec la source « Serveur ».
- Un jour plus tard, ouvrez l'onglet Vue d'ensemble : vous devriez voir des événements reçus du navigateur et du serveur, avec la déduplication indiquée pour ceux qui se recoupent.
- Surveillez la qualité de la correspondance des événements. Si elle est faible, il manque probablement l'e-mail, le téléphone ou les identifiants de clic.
- Comparez le Gestionnaire de publicités avec votre CRM pendant une ou deux semaines. Les chiffres ne correspondront jamais parfaitement, mais l'écart doit nettement se réduire.
Réponses courtes aux questions fréquentes
L'API Conversions est-elle gratuite ?
Meta ne facture pas l'API elle-même. Vous payez ce qui la fait tourner : du temps de développement, l'hébergement cloud de la passerelle ou l'abonnement à une intégration.
Est-ce la même chose que l'« API Conversions de Facebook » ?
Oui. C'est le même produit ; la plateforme publicitaire de Facebook s'appelle désormais Meta. « CAPI », « Facebook CAPI » et « API Conversions de Meta » sont employés indifféremment.
En ai-je besoin si je ne fais que de la génération de leads, sans vente en ligne ?
C'est sans doute là qu'elle est la plus utile. Sans elle, Meta optimise pour des formulaires remplis — y compris les faux numéros et les gens qui ne décrochent jamais. Avec les étapes du CRM envoyées via la CAPI, Meta peut optimiser pour les leads qui deviennent des clients payants.
Va-t-elle casser mon pixel actuel ?
Non. La CAPI fonctionne en parallèle du pixel. Le seul point à soigner est la déduplication, pour qu'un même achat ne soit pas compté deux fois.
Prochain article de la série : Conversions API Gateway — combien elle coûte vraiment et quand ce n'est pas le bon choix.