API Conversions Meta : configurer la CAPI correctement à côté du Pixel

L’API Conversions de Meta (CAPI) est une connexion de serveur à serveur qui envoie des conversions comme un lead, une demande de démo ou un achat directement depuis votre serveur ou votre CRM vers Meta. Vous la configurez à côté du Meta Pixel, vous donnez à chaque événement le même identifiant dans le navigateur et sur le serveur pour que Meta élimine les doublons, et vous testez le résultat dans le Gestionnaire d’événements. Meta Ads apprend ainsi sur des données de conversion plus nombreuses et plus fiables que ce que le navigateur seul transmet.

Ce guide porte sur le côté serveur. Si vous voulez d’abord comprendre ce que mesure le Pixel lui-même et quels événements existent, lisez notre explication du Meta Pixel. Cet article commence là où celui-ci s’arrête : comment choisir, configurer, dédupliquer et contrôler la CAPI.

Que fait exactement l’API Conversions de Meta ?

Selon la documentation de Meta, l’API Conversions établit une connexion entre les données marketing d’un annonceur, depuis le serveur, la plateforme du site, une application ou le CRM, et les systèmes de Meta qui optimisent le ciblage et la diffusion. Les événements serveur servent à la mesure, au reporting et à l’optimisation, tout comme les événements du Pixel.

La différence tient au chemin emprunté. Le Pixel tourne dans le navigateur de votre visiteur. Là, les bloqueurs de publicité, les restrictions de suivi de Safari et les scripts qui ne se chargent pas jouent tous un rôle. La CAPI part de chez vous : votre propre serveur, votre conteneur de tagging server-side ou votre CRM. Cela a trois conséquences qui comptent en B2B :

• Moins de leads manqués. Un formulaire que le navigateur ne transmet pas, votre serveur peut encore le signaler.
• Des conversions qui se produisent hors du site. Un lead qui devient trois semaines plus tard une opportunité qualifiée dans votre CRM peut être renvoyé comme événement.
• La maîtrise de ce que vous partagez. Vous décidez vous-même quels champs partent, hachés bien sûr.

Quelle configuration choisir : partenaire, Gateway ou GTM server-side ?

Meta cite trois manières de connecter la CAPI : une intégration partenaire, la Conversions API Gateway et une intégration directe. En pratique, nous voyons quatre variantes dans les entreprises belges et néerlandaises.

Pour la plupart des entreprises B2B qui annoncent aussi sur Google Ads et LinkedIn, GTM server-side est la base logique. Vous construisez une seule couche server-side et vous alimentez toutes les plateformes à partir de celle-ci. Vous découvrez comment fonctionne cette couche dans notre guide sur le server-side tracking.

Si vous avez des conversions tardives (un lead n’est qualifié qu’après un entretien commercial), la voie du CRM s’ajoute. Faites attention à la limite de temps : la documentation des paramètres de Meta indique que event_time peut remonter jusqu’à 7 jours dans le passé. Un deal conclu après six semaines ne s’envoie donc plus comme événement du site.

Comment configurer l’API Conversions de Meta, étape par étape ?

Voici l’ordre que nous suivons pour chaque configuration.

1. Cartographiez vos conversions. Quels événements comptent vraiment ? En B2B, il s’agit généralement de Lead (formulaire), de Schedule ou d’un événement personnalisé pour une démo réservée, et éventuellement de CompleteRegistration pour un webinaire. Une page vue n’est pas une conversion.
2. Prévoyez une couche de données. Chaque formulaire pousse un événement portant le même nom et un identifiant d’événement unique dans la couche de données. Sans cet identifiant, Meta ne peut pas dédupliquer. Vous lisez comment mesurer de façon fiable les formulaires sans page de remerciement dans notre guide sur les conversions de formulaire sans page de remerciement.
3. Envoyez le même événement via le Pixel. La balise du Pixel reçoit l’identifiant d’événement comme eventID.
4. Envoyez le même événement via le serveur. Dans votre conteneur server-side ou votre intégration, l’événement part vers la CAPI avec event_name, event_time, event_id, action_source website, event_source_url et les informations client.
5. Ajoutez les informations client. Une adresse e-mail hachée (em), un numéro de téléphone (ph), les valeurs fbp et fbc ainsi que l’adresse IP et le user agent du visiteur. Meta exige client_user_agent pour les événements du site et demande de hacher les coordonnées en SHA-256, tandis que fbp, fbc, l’IP et le user agent ne sont pas hachés, comme l’indique la documentation sur les paramètres client.
6. Respectez le consentement. La balise server-side ne se déclenche que si le visiteur a accepté le marketing. Nous y revenons plus loin dans cet article.
7. Testez et contrôlez. Utilisez le code d’événement de test dans le Gestionnaire d’événements avant la mise en ligne, puis suivez la déduplication et la qualité de la correspondance.

Comment fonctionne la déduplication entre le Pixel et la CAPI ?

Si vous envoyez le même événement via le navigateur et le serveur, Meta le reçoit deux fois. La déduplication garantit qu’il ne compte qu’une fois. Les règles figurent dans le guide de déduplication de Meta :

• l’eventID du Pixel doit être identique à l’event_id de la CAPI ;
• le nom d’événement du Pixel doit être identique à event_name dans la CAPI ;
• les événements ne sont dédupliqués que s’ils arrivent dans les 48 heures suivant le premier événement portant cet identifiant ;
• Meta conserve généralement l’événement reçu en premier.

Vous créez l’identifiant dans le navigateur, au moment où le formulaire est envoyé, et vous le transmettez via la couche de données à la fois à la balise du Pixel et à la balise server-side. Un horodatage seul n’est pas un bon identifiant : deux leads dans la même seconde reçoivent alors le même numéro.

Meta décrit aussi une méthode alternative avec event_name plus fbp ou external_id. Elle fonctionne, mais elle est moins prévisible. Nous utilisons toujours un identifiant d’événement explicite.

Quelles erreurs voyons-nous le plus souvent avec la CAPI ?

Dans les comptes que nous contrôlons, les mêmes problèmes reviennent sans cesse :

• Le double comptage. Le Pixel et la CAPI envoient le même événement sans identifiant partagé. Le nombre de leads dans le Gestionnaire de publicités double, le coût par lead est divisé par deux sur le papier, et l’algorithme apprend sur une image faussée.
• Deux sources pour le même événement. Le plug-in Shopify ou WordPress envoie des événements CAPI et votre conteneur server-side le fait aussi. Une source par événement, pas deux.
• Aucune information client. Des événements CAPI sans e-mail, fbp ou fbc, Meta peut difficilement les relier à une personne. Ils ne comptent alors presque pas pour l’optimisation.
• Des champs non hachés ou mal hachés. Hacher une adresse e-mail contenant des majuscules ou des espaces donne un autre hash. Normalisez d’abord (minuscules, espaces supprimés), hachez ensuite.
• Chaque clic sur un formulaire compté comme Lead. Les inscriptions à la newsletter et les candidatures arrivent alors aussi comme leads. Meta optimise ensuite sur les moins chers, pas sur les meilleurs. Cela ressemble fort à ce que nous décrivons dans nettoyer les fausses conversions.
• Contourner le consentement. « C’est du server-side, donc la bannière cookies ne compte pas » est un malentendu. Nous y revenons ci-dessous.

Comment tester si l’API Conversions fonctionne ?

Contrôlez dans cet ordre :

1. Événements de test dans le Gestionnaire d’événements. Saisissez votre code d’événement de test dans votre balise server-side, envoyez un formulaire de test et vérifiez que l’événement arrive via le navigateur et via le serveur.
2. La déduplication. Dans l’aperçu de votre jeu de données, vous voyez par événement si les événements navigateur et serveur sont dédupliqués. Si vous en voyez deux séparés, l’identifiant ou le nom d’événement ne correspond pas.
3. La qualité de la correspondance. Le Gestionnaire d’événements affiche par événement un score de qualité des informations client. S’il est faible, vérifiez que l’e-mail, fbp et fbc sont bien envoyés.
4. L’aperçu dans GTM. Dans l’aperçu de vos conteneurs web et serveur, vous voyez si l’identifiant d’événement est le même dans les deux balises.
5. La comparaison avec le CRM. Mettez le nombre de leads Meta par semaine à côté du nombre de leads venant de Meta dans votre CRM. Un grand écart signale des doublons ou des événements manqués.

Nous réalisons un contrôle complet de votre mesure, Google Ads et GA4 compris, dans un audit tracking. Si vous voulez commencer vous-même, utilisez notre checklist d’audit du suivi des conversions.

Pouvez-vous utiliser la CAPI sans consentement aux cookies ?

Non, pas pour le marketing. L’Autorité de protection des données belge indique qu’aucun cookie ou autre traceur non strictement nécessaire ne peut être placé ou lu sans information préalable et consentement. Aux Pays-Bas, l’Autoriteit Persoonsgegevens suit la même ligne. Que les données passent par votre serveur ne change rien à la finalité : la mesure et le ciblage publicitaires. Faites donc dépendre votre balise server-side du même consentement que votre Pixel.

Ce que la CAPI résout en revanche : les pertes qui ne viennent pas d’un refus, comme les bloqueurs de publicité, les restrictions des navigateurs et les scripts qui se chargent trop tard. Vous découvrez comment bien configurer votre bannière et les signaux Google dans notre guide sur le consent mode v2 et dans la bannière cookies est-elle obligatoire en Belgique. Cet article ne constitue pas un avis juridique : soumettez votre configuration à votre DPO ou à votre juriste.

Comment renvoyer les données du CRM vers Meta ?

En B2B, le vrai gain ne se situe pas dans le formulaire, mais dans ce qui se passe ensuite. Un lead qui ne décroche jamais a pour Meta autant de valeur qu’un lead qui devient client, sauf si vous lui renvoyez la différence.

1. Conservez pour chaque lead la valeur fbc (dérivée du fbclid dans l’URL), le cookie fbp et une adresse e-mail hachée dans votre CRM.
2. Déterminez quelle phase du CRM vous renvoyez, par exemple « qualifié » ou « démo réalisée ».
3. Envoyez cette phase comme événement avec action_source system_generated ou website, dans le délai que Meta autorise.
4. Optimisez vos campagnes sur cet événement plus profond dès qu’il y a assez de volume.

Nous appliquons la même logique pour Google Ads dans importer des conversions hors ligne depuis votre CRM. Chez Kaizo, nous avons construit la mesure Meta sur la même démo réservée que Google Ads, afin que les deux canaux optimisent sur le même événement : lisez le cas tracking de Kaizo. Et découvrez comment un seul écouteur de formulaire cassé a mis à l’arrêt en même temps GA4, Google Ads, Meta et LinkedIn dans le cas Suivo.

Quand n’avez-vous pas (encore) besoin de l’API Conversions ?

Si vous annoncez à peine sur Meta, ou si vos leads arrivent surtout via les formulaires Lead Ads dans Facebook et Instagram, la CAPI pour les formulaires du site rapporte peu. Avec des volumes très faibles (une poignée de leads par mois), un Pixel correct avec de bons noms d’événements et un enregistrement propre dans le CRM compte davantage qu’une couche server-side. Commencez par là, et ajoutez la CAPI dès que Meta devient un vrai canal dans votre approche Meta Ads.

Vous voulez faire configurer la CAPI en même temps que votre mesure Google Ads, LinkedIn et GA4 ? Notre spécialiste tracking le fait dans une seule configuration server-side, sur mesure et sur demande. Contactez-nous pour un premier contrôle.

Si vous annoncez sur plusieurs plateformes, lisez aussi nos guides sur LinkedIn Insight Tag, TikTok Pixel, server-side tracking et Stape.

Questions fréquentes

Quelle est la différence entre le Meta Pixel et l’API Conversions ?

Le Pixel mesure dans le navigateur du visiteur, l’API Conversions envoie des événements depuis votre serveur ou votre CRM. Meta recommande d’utiliser les deux et de les dédupliquer avec un identifiant d’événement partagé.

Ai-je besoin de Google Tag Manager server-side pour la CAPI ?

Non. Une intégration partenaire ou la Conversions API Gateway convient aussi. GTM server-side devient surtout intéressant si, en plus de Meta, vous voulez alimenter Google Ads, LinkedIn ou TikTok en server-side depuis un seul conteneur.

Pourquoi vois-je des conversions en double après avoir installé la CAPI ?

Le plus souvent, l’identifiant d’événement partagé manque, le nom d’événement diffère entre le Pixel et le serveur, ou deux intégrations (par exemple un plug-in et votre conteneur serveur) envoient le même événement.

Puis-je envoyer des conversions hors ligne via l’API Conversions ?

Oui, tant que l’événement reste dans le délai que Meta autorise. Pour les conversions B2B tardives, conservez fbc, fbp et une adresse e-mail hachée avec le lead dans votre CRM, afin que Meta puisse relier la conversion à la bonne personne.

La CAPI fonctionne-t-elle si un visiteur refuse les cookies ?

Techniquement, le serveur peut envoyer des événements, mais en Belgique et aux Pays-Bas, vous ne pouvez pas le faire à des fins marketing sans consentement. La CAPI répare surtout les pertes dues aux bloqueurs de publicité et aux restrictions des navigateurs, pas celles dues à un refus.