API Conversions Meta : le guide de contrôle de l'annonceur
En 30 secondes
API Conversions Meta : pixel, ensemble de données, déduplication, qualité de correspondance, iOS et consentement. Ce que l'annonceur doit exiger et vérifier.
- 12 min de lecture
- 9 parties
- Dossier Social ads
En bref : L'API Conversions envoie vos conversions à Meta depuis votre serveur, en plus du pixel qui les envoie depuis le navigateur. Pour l'annonceur, quatre contrôles comptent : l'ensemble de données appartient à votre entreprise, les doublons sont supprimés grâce à l'event_id, la qualité de correspondance est suivie et le consentement est respecté.
Quand un prestataire installe le suivi Meta, l'annonceur reçoit souvent une phrase du type « le pixel et l'API Conversions sont en place ». Elle ne dit rien de ce qui compte : les achats sont-ils comptés une seule fois, Meta reconnaît-il les acheteurs, et les données partent-elles avec l'accord des visiteurs ? Ce guide liste ce que vous devez comprendre, exiger et vérifier vous-même dans le Gestionnaire d'évènements. Il s'appuie sur l'aide Meta Business, la documentation Meta for Developers, la CNIL et l'aide Google Tag Manager, consultées le 5 novembre 2026.
Il ne décrit pas l'installation pas à pas. Si vous voulez voir le côté technique, kenoby détaille l'installation du pixel Meta et la configuration de l'API Conversions.
Pixel et API Conversions : deux canaux pour les mêmes évènements
Le pixel Meta est un code placé sur votre site : il envoie les actions des visiteurs depuis leur navigateur. L'API Conversions envoie des évènements depuis votre serveur, votre plateforme e-commerce ou votre CRM. D'après la page de recommandations de Meta sur l'API Conversions, la configuration conseillée est « redondante » : les mêmes évènements partent par les deux canaux, pour récupérer ceux que le pixel perd à cause de problèmes de réseau ou d'erreurs de chargement des pages.
| Pixel Meta | API Conversions | |
|---|---|---|
| D'où partent les données | Navigateur du visiteur | Votre serveur, votre plateforme ou votre CRM |
| Ce qui peut les bloquer | Bloqueurs, réglages du navigateur, page qui charge mal | Erreur d'intégration, panne ou retard d'envoi du serveur |
| Évènements possibles | Évènements du site | Site, application, magasin, hors ligne, messages |
| Ce que vous vérifiez | Que chaque évènement clé se déclenche une fois, au bon moment | Que les mêmes évènements arrivent, sans doublon, avec assez d'informations clients |
Meta donne aussi un objectif chiffré : viser une couverture de 75 % des évènements de l'API Conversions par rapport au pixel. Autrement dit, sur 100 achats vus par le pixel, au moins 75 doivent aussi arriver par le serveur. Meta recommande enfin d'envoyer les évènements en temps réel ou au plus près : pour une campagne avec l'objectif Ventes, sa page sur les délais d'envoi conseille de le faire dans l'heure, avec un maximum de 7 jours.
L'ensemble de données doit rester à votre nom
Les évènements arrivent dans un ensemble de données, visible dans le Gestionnaire d'évènements. Pour un site seul, Meta indique qu'il n'est pas nécessaire d'en créer un : l'API Conversions utilise l'ID de votre pixel. Si vous ajoutez une application, l'ensemble de données créé à partir du pixel garde le même ID.
Le point de contrôle est la propriété. Dans la procédure de Meta, c'est le portefeuille business qui possède l'ensemble de données qui ajoute un partenaire, avec le niveau d'accès choisi. Le partenaire doit avoir son propre portefeuille. Si votre prestataire a créé le pixel dans son portefeuille à lui, vous dépendez de lui pour l'historique de vos conversions et vos audiences. Demandez que l'ensemble de données soit créé, ou transféré, dans votre portefeuille, et que le prestataire y ait un accès de partenaire.
La déduplication, premier point à vérifier
Avec une configuration redondante, Meta reçoit chaque achat deux fois. Sans déduplication, les conversions sont gonflées, le coût par achat paraît plus bas qu'il n'est et les enchères s'appuient sur de faux chiffres. La page d'aide de Meta sur la déduplication fixe deux conditions pour que deux évènements soient reconnus comme un seul :
- le nom de l'évènement (event_name, par exemple Purchase) est le même côté navigateur et côté serveur ;
- l'identifiant de l'évènement (event_id) est identique dans les deux envois.
À défaut d'event_id, Meta peut dédupliquer avec le nom de l'évènement et les paramètres external_id ou fbp. Quand les deux évènements sont semblables, Meta garde celui qui est arrivé en premier. La documentation pour les développeurs précise une limite utile : les deux envois doivent arriver dans un délai de 48 heures pour être dédupliqués.
La déduplication n'est nécessaire que si le même évènement part des deux côtés. Si le navigateur envoie l'ajout au panier et le serveur l'achat, il n'y a rien à dédupliquer. Demandez donc à votre prestataire la liste des évènements envoyés par chaque canal.
Comment le vérifier vous-même. Dans le Gestionnaire d'évènements, ouvrez l'évènement Purchase : Meta y affiche les sources (navigateur et serveur) et le statut de déduplication. L'outil de test des évènements permet de passer une commande test et de voir si elle est reçue, dédupliquée ou abandonnée. Comparez ensuite le nombre d'achats sur une semaine avec celui de votre back-office : si Meta en compte nettement plus, cherchez d'abord des doublons.
La qualité de correspondance des évènements (EMQ)
Un évènement n'aide vos campagnes que si Meta peut le relier à un compte Facebook ou Instagram. La qualité de correspondance des évènements mesure cette capacité par une note de 0 à 10. Elle concerne les évènements de site envoyés par l'API Conversions et se calcule sur les 48 dernières heures. Un évènement envoyé rarement a donc une note qui se met mal à jour.
La note dépend des informations clients jointes à l'évènement. Meta publie leur priorité :
| Priorité selon Meta | Paramètres |
|---|---|
| Élevée | Adresse e-mail, ID de clic |
| Moyenne | ID Facebook Login, date de naissance, pays, numéro de téléphone, ID externe, ID de navigateur |
| Faible | Prospect, prénom, nom, ville, code postal |
Deux règles encadrent ces données. La documentation développeurs de Meta exige que les coordonnées (e-mail, téléphone, nom) soient hachées en SHA-256 avant l'envoi ; le SDK Meta Business le fait automatiquement. Et les conditions de Meta imposent d'avoir les autorisations légales et les consentements nécessaires avant tout partage. Une meilleure note ne justifie jamais d'envoyer une donnée que vous n'avez pas le droit de transmettre.
Ce qu'il faut demander : la note de chaque évènement important (achat, prospect, début de paiement), les paramètres envoyés pour chacun, et les recommandations que le Gestionnaire d'évènements affiche pour l'améliorer.
Après iOS 14 : ce qui a changé dans la mesure agrégée
Depuis iOS 14.5, Meta mesure les conversions des utilisateurs d'iPhone avec le protocole de mesure agrégée des évènements. Ce traitement supprime les identifiants, ajoute de la confidentialité différentielle et agrège les données avant la mesure. Les évènements envoyés par l'API Conversions peuvent eux aussi être soumis à ses limites : le serveur ne contourne pas les règles d'iOS.
La partie la plus visible pour l'annonceur a changé. D'après la même page, pour les conversions sur un site :
- il n'est plus nécessaire de classer 8 évènements de conversion par domaine, ni d'activer des ensembles de valeurs ;
- l'onglet dédié à la mesure agrégée a disparu du Gestionnaire d'évènements ;
- la vérification du domaine n'est plus exigée pour configurer les évènements (elle peut l'être pour d'autres raisons) ;
- il n'y a plus de domaine de conversion à choisir en créant une campagne.
Un devis ou un audit qui facture encore la « priorisation des 8 évènements » s'appuie donc sur une règle retirée. Le travail utile porte aujourd'hui sur la qualité des évènements, leur déduplication et leur couverture.
Consentement : CNIL, bannière et Consent Mode
En France, la CNIL rappelle que les cookies liés à la publicité personnalisée et ceux des réseaux sociaux demandent un consentement préalable, libre, spécifique, éclairé, univoque et retirable aussi simplement qu'il a été donné (Cookies et traceurs : que dit la loi ?). L'obligation pèse sur l'éditeur du site, mais aussi sur les régies publicitaires et les réseaux sociaux, que la CNIL considère comme responsables conjoints.
Côté navigateur, le pixel Meta prévoit deux commandes : fbq('consent', 'revoke') met les envois en pause, fbq('consent', 'grant') les autorise une fois l'accord donné. Côté serveur, rien dans la documentation de Meta ne présente l'API Conversions comme un moyen de se passer du consentement : ses conditions exigent les autorisations et consentements nécessaires avant le partage des données.
Le Consent Mode est un mécanisme de Google, pas de Meta. Dans Google Tag Manager, les balises Google ajustent leur comportement selon les états ad_storage, ad_user_data, ad_personalization et analytics_storage. Les autres balises, dont celles de Meta, ne le font pas d'elles-mêmes : l'aide Tag Manager sur le mode Consentement prévoit pour elles une option « Vérifications supplémentaires du consentement », qui bloque le déclenchement tant que les consentements choisis ne sont pas accordés.
Le contrôle à faire est simple : refusez les cookies sur votre site, naviguez jusqu'à une page produit, puis regardez avec l'outil de test des évènements si quelque chose arrive chez Meta. Faites valider ensuite le schéma complet (navigateur et serveur) par votre délégué à la protection des données ou votre conseil.
Shopify, GTM côté serveur, gateway : ce que chaque option implique
Meta propose plusieurs façons d'installer l'API Conversions. Elles n'engagent pas les mêmes coûts ni les mêmes contrôles.
| Option | Pour qui | Ce qu'elle implique | Ce que vous vérifiez |
|---|---|---|---|
| Intégration partenaire (Shopify, WooCommerce, etc.) | Boutique sur une plateforme e-commerce | Selon Meta, ces plateformes gèrent souvent la déduplication elles-mêmes. Sur Shopify, l'application Facebook et Instagram demande un forfait Basic ou supérieur et une boutique sans mot de passe | Le niveau de partage des données choisi dans Shopify et sa cohérence avec votre bannière de consentement |
| Gateway API Conversions | Site qui utilise déjà le pixel, sans plateforme partenaire | Option sans code hébergée sur AWS ou Google Cloud. Meta annonce une déduplication automatique et des frais d'hébergement à partir de 30 $ par mois | Le compte cloud est à votre nom, et qui paie et surveille l'hébergement |
| GTM côté serveur | Site déjà équipé de Google Tag Manager et de GA4 | Un conteneur serveur sur Google Cloud ou un autre fournisseur, avec le tag API Conversions écrit par Meta | Qui maintient le serveur, et si les règles de consentement du conteneur web s'appliquent aussi aux évènements envoyés à Meta |
| Intégration directe | Site sur mesure, équipe technique disponible | Code développé pour votre serveur | Les paramètres envoyés, le hachage et la déduplication, documentés par écrit |
Sur Shopify, Meta recommande après l'installation de choisir un partage des données « Amélioré » ou « Maximum » et un accès aux données « Toujours activé » ou « Optimisé ». Avant de suivre ce conseil, vérifiez avec votre conseil ce que chaque option fait des visiteurs qui ont refusé les cookies.
La grille de contrôle de l'annonceur
À remplir avec votre prestataire une fois l'installation terminée, puis à revoir chaque trimestre.
| Point de contrôle | Où le vérifier | Résultat attendu |
|---|---|---|
| Propriété de l'ensemble de données | Paramètres de Meta Business Suite, Sources de données | L'ensemble de données appartient à votre portefeuille ; le prestataire est partenaire |
| Évènements envoyés par chaque canal | Gestionnaire d'évènements, détail de chaque évènement | Liste écrite : quels évènements partent du navigateur, du serveur, ou des deux |
| Déduplication | Gestionnaire d'évènements et outil de test des évènements | Même event_name et même event_id ; une commande test apparaît une seule fois |
| Nombre d'achats | Gestionnaire d'évènements comparé à votre back-office | Écart faible et expliqué, jamais un doublement |
| Qualité de correspondance | Gestionnaire d'évènements, évènements serveur | Note suivie pour chaque évènement clé, avec la liste des paramètres envoyés |
| Couverture serveur | Gestionnaire d'évènements | Au moins 75 % des évènements du pixel arrivent aussi par l'API Conversions |
| Délai d'envoi | Gestionnaire d'évènements, actualisation des données | Évènements envoyés en temps réel ou dans l'heure |
| Valeur et devise | Détail de l'évènement Purchase | Montant et devise transmis à chaque achat |
| Hachage | Documentation fournie par le prestataire | E-mail, téléphone et nom hachés en SHA-256 avant l'envoi |
| Consentement | Test avec refus des cookies | Aucun envoi publicitaire tant que le visiteur n'a pas accepté, schéma validé par votre conseil |
| Règles iOS | Devis et rapports | Aucune facturation de la « priorisation des 8 évènements », retirée par Meta |
Pour lire ensuite les conversions remontées, notre article sur les modèles d'attribution de Google Ads, GA4 et Meta explique pourquoi les chiffres de Meta diffèrent de ceux de vos autres outils, et notre guide du coût par conversion aide à juger le coût obtenu. Un suivi fiable est aussi la condition des campagnes automatisées : c'est le sujet de notre guide Meta Advantage+ pour l'annonceur.
FAQ : vos questions sur le sujet
Le pixel Meta suffit-il encore ?
Il fonctionne, mais Meta recommande d'ajouter l'API Conversions et d'envoyer les mêmes évènements par les deux canaux. Le pixel dépend du navigateur, qui peut bloquer ou perdre des évènements.
Qu'est-ce que l'event_id ?
C'est l'identifiant unique d'un évènement, par exemple d'une commande. Envoyé à l'identique par le pixel et par le serveur, avec le même nom d'évènement, il permet à Meta de ne compter l'achat qu'une fois.
Quelle note de qualité de correspondance viser ?
Meta ne fixe pas de seuil public dans sa page d'aide. La note va de 0 à 10 ; suivez-la par évènement et appliquez les recommandations affichées dans le Gestionnaire d'évènements, dans la limite des données que vous avez le droit d'envoyer.
Faut-il encore configurer 8 évènements pour iOS ?
Non. Meta indique que la priorisation des 8 évènements par domaine et l'activation des ensembles de valeurs ne sont plus nécessaires pour les conversions sur un site.
L'API Conversions permet-elle de suivre les visiteurs qui refusent les cookies ?
Meta ne la présente pas ainsi : ses conditions exigent les autorisations et consentements nécessaires avant tout partage. En France, la publicité personnalisée relève du consentement préalable selon la CNIL. Faites valider votre configuration par votre conseil.
Sources et références
- Recommandations relatives à l'API Conversions, aide Meta Business, consultée le 5 novembre 2026
- À propos de la déduplication des évènements du pixel Meta et de l'API Conversions, aide Meta Business, consultée le 5 novembre 2026
- À propos de la qualité de correspondance des évènements, aide Meta Business, consultée le 5 novembre 2026
- À propos du protocole de mesure agrégée des évènements de Meta, aide Meta Business, consultée le 5 novembre 2026
- Cookies et traceurs : que dit la loi ?, CNIL, consultée le 5 novembre 2026
- Compatibilité du mode Consentement dans Tag Manager, aide Tag Manager, consultée le 5 novembre 2026
Autres pages lues le même jour : aide Meta Business sur l'API Conversions, les délais d'envoi des évènements, les options de création d'ensemble de données, l'ajout de partenaires à un ensemble de données, le gateway API Conversions et l'association de Shopify ; documentation Meta for Developers sur la déduplication (mise à jour du 28 juin 2026), les paramètres d'informations clientèle (9 janvier 2026), GTM côté serveur (30 juin 2026) et le consentement du pixel.