L'API Conversions de Facebook expliquée : comment Meta continue de suivre vos conversions malgré les restrictions liées aux cookies

Écrit par :

Iryna Bundzylo

9

min de lecture

Date :

September 3, 2026

Date de modification :

September 3, 2026

Depuis quelques années, le navigateur est devenu un messager peu fiable. Les invites de confidentialité d'iOS, les bloqueurs de publicités et les restrictions sur les cookies tiers ont progressivement réduit la visibilité de Meta sur le parcours client avant la prise de décision publicitaire. L'API Conversions de Facebook (que Meta appelle Conversions API, ou CAPI) est la solution conçue par Meta pour résoudre ce problème spécifique.

La CAPI est unique en son genre et ne peut être remplacée par des outils tiers. Cependant, des solutions comme Data365 peuvent la compléter en enrichissant les données transmises à Meta, rendant ainsi vos campagnes publicitaires plus performantes grâce aux données.

Important: Data365 doesn’t provide a "CAPI event." It can provide social data from which your system identifies an event. Throwing a bit of social-platform data alongside a CAPI implementation can contribute to a qualifying customer event, and the resulting event can be passed to Meta through CAPI.

Aperçu rapide

  • Qu'est-ce que la CAPI : une API serveur à serveur qui transmet des données d'événements (achats, prospects, inscriptions, conversions hors ligne) directement depuis le serveur, le CRM ou la plateforme web de l'annonceur vers Meta.
  • Pourquoi elle existe : le suivi basé sur le navigateur manque de plus en plus d'événements en raison des fonctionnalités de confidentialité, des bloqueurs de publicités et des limites imposées aux cookies.
  • Comment elle fonctionne : votre serveur envoie des données d'événements structurées (nom de l'événement, horodatage, identifiants client hachés, paramètres personnalisés) vers un point de terminaison Meta associé à un jeu de données.
  • Ses limites : la CAPI ne fait qu'envoyer des données. Si votre équipe a également besoin de récupérer des données depuis Meta (publications, engagement, statistiques de page ou de publicité), il s'agit d'un outil différent.

Dans cet article, nous détaillerons le fonctionnement réel de la CAPI, sa configuration, la structure d'une charge utile (payload) conforme, ses points de convergence avec le Pixel et Google Tag Manager, ainsi que les limites inhérentes à l'écosystème de suivi de Meta, pour lesquelles il n'a jamais été conçu.

Comment fonctionne réellement l'API Conversions de Facebook

Au-delà de la technique, le processus est simple : un événement se produit sur votre site ou dans vos systèmes (un achat, un formulaire de prospect, une inscription) et cette information doit atteindre Meta pour que son système publicitaire puisse attribuer la conversion à la bonne campagne et optimiser ses performances. Il existe deux méthodes pour effectuer ce transfert, et la plupart des entreprises utilisent les deux simultanément : l'une rapporte les données depuis le navigateur du visiteur, l'autre depuis votre serveur.

Facebook CAPI VS Pixel

Voici en quoi consiste chacune d'elles et comment elles s'articulent.

Le rôle du Pixel

Le Pixel Meta est un petit morceau de code JavaScript que vous intégrez au code de votre site web. Il réside dans le navigateur du visiteur et transmet des informations à Meta dès qu'une action traçable se produit (consultation de page, ajout au panier, achat finalisé). C'est la configuration standard depuis des années, et elle fonctionne tant que le navigateur coopère : le script doit se charger, le cookie doit être défini, et rien ne doit bloquer la requête en cours de route.

Ce que change la CAPI

De plus en plus, quelque chose finit par bloquer cette requête. La CAPI contourne cette dépendance. Au lieu de compter sur le navigateur pour signaler un événement, votre propre serveur l'envoie directement à Meta ; le même serveur qui vient de traiter le paiement et qui sait, avec certitude, qu'un achat a eu lieu. Aucun script à charger, aucun cookie à définir, rien qu'un bloqueur de publicités ou un paramètre de confidentialité puisse intercepter.

API Conversions de Facebook vs Pixel

Ce ne sont pas des concurrents, mais la distinction est facile à brouiller. Il est donc utile de clarifier les choses, maintenant que les deux ont été expliqués :

Meta Pixel Conversions API
Where it runs In the visitor's browser On your server
Depends on Browser cooperation, cookies loading, scripts not being blocked Your own infrastructure sending the request
Vulnerable to Ad blockers, ITP/iOS restrictions, cookie consent rejections Server downtime, implementation errors – not browser behavior
Setup effort Low – a JavaScript snippet Higher – server-side implementation or partner tool
Meta's recommendation Run alongside CAPI, not instead of it Run alongside Pixel, deduplicated by event_id

Pour résumer en toute franchise : le Pixel est économique et simple à déployer, mais de plus en plus lacunaire. L'API Conversions (CAPI) demande plus d'efforts, mais s'avère bien plus pérenne. En combinant les deux avec une déduplication rigoureuse – comme expliqué ci-dessus –, vous obtiendrez une vue d'ensemble bien plus complète qu'avec l'une ou l'autre de ces solutions prises séparément.

Que contient réellement un événement

Chaque événement que vous envoyez comporte un ensemble de champs :

  • event_name (Achat, Prospect, Inscription terminée).
  • event_time.
  • Des éléments hachés de user_data (e-mail, téléphone, identifiant externe – toujours hachés, jamais envoyés en clair).
  • custom_data pour des détails tels que la valeur de la commande ou la devise.

Les événements sont liés à un jeu de données, et ce même jeu de données peut également collecter des événements d'application, des conversions hors ligne et des messages professionnels : un canal unique pour tout centraliser, plutôt qu'un flux séparé par source.

Une liste de détails bien courte, pourriez-vous penser. Eh bien, vous pouvez l'enrichir un peu pour aider Meta à mieux comprendre votre activité en collectant des données issues des réseaux sociaux et en les utilisant pour obtenir une compréhension plus approfondie de vos clients et audiences au sein de votre propre pile de données.

Avec Data365, voici à quoi cela pourrait ressembler :

  • Data365 vous aide à collecter et à comprendre les signaux sociaux externes sur Facebook.
  • Vos propres systèmes transforment ces signaux et vos données propriétaires en événements commerciaux ou en attributs clients pertinents.
  • CAPI renvoie les signaux de conversion pris en charge vers Meta.

Si vous souhaitez faire un essai, contactez-nous. Notre équipe vous aidera à enrichir vos données dès aujourd'hui.

Éviter les doubles comptages entre le Pixel et CAPI

Spiderman Pointing meme – Browser events versus server events in Facebook CAPI and Pixel

La plupart des configurations utilisent le Pixel et CAPI simultanément, ce que Meta recommande d'ailleurs. Mais cela signifie qu'une même conversion réelle peut arriver deux fois : une fois depuis le navigateur, une fois depuis votre serveur. En associant un event_id identique aux deux, Meta les fusionne en un seul événement au lieu de deux. Si vous sautez cette étape, vos chiffres seront gonflés : tout semblera mieux convertir qu'en réalité, sans qu'aucune erreur ne vous alerte sur la situation.

Comment configurer l'API de conversion Facebook

Avant de toucher à CAPI, votre Pixel doit déjà être actif et opérationnel, car CAPI vient se superposer à lui. À partir de là, la configuration suit quelques étapes concrètes :

  1. Confirmez vos accès. Vous aurez besoin de permissions de niveau administrateur sur le compte Business Manager concerné pour générer des jetons d'API Facebook.
  2. Localisez l'identifiant de votre Pixel/jeu de données. Il se trouve en haut de la page de présentation du Pixel dans le Gestionnaire d'événements, et c'est l'identifiant auquel chaque événement envoyé fera référence.
  3. Générez un jeton d'accès. Dans le Gestionnaire d'événements, sous l'onglet Paramètres du Pixel, la section API de conversions propose une option « Générer un jeton d'accès ». Meta crée automatiquement l'application et l'utilisateur système associés pour vous ; pas besoin d'examen d'application ni de demande de permission, une générosité inhabituelle selon les standards de Meta.
  4. Choisissez un mode d'intégration. Une intégration partenaire (Shopify, CRM, outil d'agence) est la voie la plus rapide si elle est disponible pour votre pile technique. Une intégration directe ou manuelle vous donne un contrôle total sur la charge utile, mais implique que votre équipe technique gère l'implémentation. Un conteneur Google Tag Manager côté serveur se situe entre ces deux options, comme nous le verrons plus loin.
  5. Envoyez un événement de test et vérifiez. L'outil de test du Gestionnaire d'événements confirme que Meta reçoit correctement les événements avant que vous ne vous y fiiez pour l'optimisation.

A quick note on the Google Tag Manager route: If your team already lives in GTM, you don't need a from-scratch server build – Meta and Google both maintain tag templates for exactly this. It's covered in full further down, since it's less a "setup step" and more its own decision about where your server-side logic lives.

Comment transmettre les données de conversion à l'API Facebook

Chaque événement CAPI est une requête POST envoyée au point de terminaison des événements de Meta, avec un corps JSON structuré autour de votre identifiant de jeu de données et de votre jeton d'accès. Nous évitons volontairement de fournir un extrait de code à copier-coller : la forme exacte dépend de la méthode utilisée (intégration serveur codée à la main, conteneur serveur GTM ou outil partenaire), et un exemple générique ne correspondrait exactement à aucune d'entre elles.

Ce qui compte plus que la syntaxe, ce sont les exigences relatives aux données elles-mêmes :

  • L'e-mail et le numéro de téléphone doivent être transmis hachés en SHA-256 et en minuscules, jamais en clair. Les modèles GTM effectuent généralement ce hachage automatiquement ; une intégration personnalisée doit le gérer elle-même, et c'est l'endroit le plus courant où une implémentation manuelle échoue silencieusement.
  • L'event_id doit toujours correspondre exactement à celui du Pixel pour que la déduplication décrite plus haut fonctionne.
  • Au-delà de l'e-mail et du téléphone, le nom, un identifiant externe haché et les champs de localisation comptent comme des clés de correspondance supplémentaires ; il n'y a pas de limite fixe, plus vous pouvez fournir de signaux fiables, mieux c'est. Le timing est également crucial : les événements sont traités de manière optimale s'ils arrivent quelques minutes après l'action réelle, bien que le point de terminaison de Meta les accepte jusqu'à sept jours plus tard.

L'outil de test d'événements du Gestionnaire d'événements, utilisant un test_event_code, confirme que les événements arrivent et sont correctement dédupliqués avant que tout cela n'affecte vos campagnes en direct ; l'alternative serait de découvrir un event_id défectueux un mois plus tard, lors d'une analyse des métriques plutôt que dans un journal de test.

Même une implémentation propre a ses limites : la qualité des champs dépend de la robustesse des identifiants que vous avez hachés au départ. La charge utile d'un formulaire de paiement reste moins riche que celle issue d'une fiche client complète. C'est là que l'intégration de données d'identité provenant d'un CRM ou de profils sociaux publics, via un outil comme Data365, tend à améliorer la qualité de correspondance des événements bien plus que n'importe quel ajustement de la requête elle-même.

API de conversion Facebook et Google Tag Manager

Si votre pile marketing repose déjà sur GTM, configurer CAPI via cet outil plutôt que de créer une intégration serveur autonome est un raccourci judicieux : vous réutilisez une infrastructure existante au lieu d'en mettre une nouvelle en place.

Cette configuration s'appuie sur le conteneur côté serveur de GTM, un concept distinct du conteneur web standard que la plupart des équipes utilisent déjà. Les événements sont déclenchés depuis votre site web vers le conteneur web comme d'habitude, puis transférés vers un conteneur serveur hébergé par vos soins (sur Google Cloud, AWS ou ailleurs). Ensuite, un modèle de balise pour l'API Conversions – maintenu par Meta, avec des variantes également proposées par la communauté et des partenaires – formate ces événements selon le schéma requis par l'API CAPI avant de les transmettre.

L'avantage pratique est la consolidation : vos événements GA4, vos conversions sur les plateformes publicitaires et vos événements CAPI peuvent tous transiter par le même conteneur serveur, ce qui simplifie le débogage et la gouvernance des données en une seule tâche au lieu de trois. Le compromis est que quelqu'un doit toujours gérer ce conteneur serveur (l'héberger, le surveiller, maintenir les modèles à jour) ; ce n'est donc pas une infrastructure totalement « gratuite », mais une infrastructure que vous payez probablement déjà dans un autre contexte.

API de conversion Facebook vs Graph API : deux rôles distincts

On nous pose constamment cette question, et il est utile de préciser pourquoi elle est un peu déroutante dès le départ : l'API CAPI et l'API Graph ne remplissent pas la même fonction. L'API CAPI est un canal sortant : elle envoie des événements de conversion à Meta pour que sa plateforme publicitaire puisse optimiser la diffusion.

L'API Graph est principalement un canal entrant : c'est par ce biais qu'une entreprise récupère les données provenant de Meta (publications, statistiques de pages et de publicités, indicateurs d'engagement, informations sur l'audience, etc., selon le point de terminaison et les autorisations concernées).

S'ils se retrouvent dans la même conversation, c'est pour une question de contexte, pas de concurrence. Une équipe qui configure CAPI cherche souvent, en parallèle, à intégrer des données sociales dans sa pile marketing : des insights d'audience pour affiner le ciblage, des données d'engagement pour valider ce qui convertit, ou des performances au niveau des pages pour le reporting.

C'est le domaine de la Graph API, et c'est parfois la partie la moins agréable du travail avec la plateforme développeur de Meta : des cycles d'examen d'application qui peuvent durer des semaines, des périmètres de permission qui changent sans préavis, et des dépréciations de points de terminaison qui cassent des intégrations construites il y a seulement quelques versions.

Aucun de ces outils ne remplace l'autre. CAPI conserve son rôle d'acheminement des événements de conversion vers la boucle d'optimisation de Meta. Mais si c'est le volet Graph API de votre pile qui pose problème, c'est un souci qui peut être résolu.

Conclusion

L'intérêt de la CAPI n'a jamais été d'être une technologie plus simple que le Pixel ; elle demande plus de travail, pas moins. Son attrait réside dans le fait qu'elle vous redonne le contrôle sur la fiabilité de votre suivi des conversions, au lieu de le laisser entre les mains d'un navigateur. La même logique s'applique un cran plus haut : plus vous contrôlez directement votre pipeline de données, plutôt que de tout faire transiter par les systèmes de Meta, moins les changements de plateforme risquent de perturber votre configuration.

Data365 récupère en temps réel les données de Facebook, Instagram et d'autres plateformes majeures. Pour une équipe ayant besoin de données fiables sur l'audience, l'engagement ou le contenu – que ce soit pour enrichir une charge utile CAPI, alimenter un tableau de bord ou simplement éviter de refondre une intégration à chaque mise à jour de l'API Graph de Meta – c'est une solution plus sereine pour obtenir ces informations.

Envie de voir comment cela s'intègre à votre écosystème technique ? Commencez un essai gratuit de 14 jours !

Extrayez des données des principaux réseaux sociaux avec l'API Data365

Demandez un essai gratuit de 14 jours et obtenez plus de 20 types de données

Contactez-nous
Sommaire
Besoin d'une API pour extraire des données de ce réseau social ?
Contactez-nous et obtenez un essai gratuit de l'API Data365
Demander un essai gratuit

Besoin d'extraire des données des réseaux sociaux ?

Demandez un essai gratuit de l'API Data365 pour l'extraction de données

Les principaux réseaux sociaux au même endroit
Tarification équitable
Support par e-mail
Documentation API détaillée
Données exhaustives, quel que soit le volume
Aucune interruption, disponibilité garantie d'au moins 99 %

FAQ

Qu'est-ce que l'API Conversions de Facebook ?

La CAPI est l'outil serveur à serveur de Meta permettant d'envoyer des événements de conversion (achats, prospects, inscriptions) directement depuis votre serveur vers le système publicitaire de Meta, en complément du Pixel plutôt qu'en remplacement.

Comment transmettre des données de conversion à l'API Facebook ?

Envoyez une requête POST vers le point de terminaison des événements de Meta avec votre identifiant de jeu de données, votre jeton d'accès et les données utilisateur hachées, comme l'e-mail ou le téléphone. Ajoutez un event_id correspondant si le Pixel est également actif, afin que les événements soient correctement dédoublonnés.

Comment configurer l'API Conversions de Facebook ?

Commencez avec un Pixel actif, puis générez un jeton d'accès dans le Gestionnaire d'événements, sous la section API Conversions. Choisissez ensuite une méthode d'intégration : outil partenaire, développement serveur manuel ou conteneur serveur GTM.

Comment utiliser l'API Conversions de Facebook ?

Envoyez des événements structurés (nom, horodatage, données utilisateur hachées) vers le point de terminaison de Meta au moment où ils se produisent, puis vérifiez leur bonne réception via l'outil de test du Gestionnaire d'événements avant de les utiliser en production.

Besoin d'une API pour extraire des données en temps réel des réseaux sociaux ?

Soumettez un formulaire pour obtenir un essai gratuit de l'API réseaux sociaux de Data365.
0/255

En soumettant ce formulaire, vous reconnaissez avoir lu, compris et accepté nos Conditions générales, qui décrivent la manière dont vos données seront collectées, utilisées et protégées. Vous pouvez consulter l'intégralité de notre Politique de confidentialité ici.

Merci ! Votre soumission a bien été reçue !
Oups ! Une erreur est survenue lors de l'envoi du formulaire.
Approuvé par