← Tous les articles

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 :

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 :

  1. 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é.
  2. 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.
  3. 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 :

  1. 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.
  2. Elle envoie un formulaire. Votre site, votre CRM ou votre intégration enregistre ses coordonnées avec cet identifiant de clic.
  3. 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.
  4. 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 fonctionneDans le navigateur du visiteurSur votre serveur, votre CRM ou une intégration
Bloqué par les bloqueurs de publicitéSouventNon
Voit les ventes hors ligne et les étapes du CRMNonOui
Voit le comportement sur la page (vues, défilement, panier)OuiSeulement ce que vous envoyez
Mise en placeColler un extrait de codeCode 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

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

  1. 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 ».
  2. 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.
  3. 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.
  4. 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.