À retenir
- L’API Conversions envoie des événements de votre serveur vers Meta. Elle travaille avec le pixel, elle ne le remplace pas.
- Quand le pixel et le serveur envoient le même événement, donnez aux deux copies le même
event_nameet le mêmeevent_idpour que Meta n’en garde qu’une. - La qualité de correspondance mesure à quel point vos informations client trouvent des comptes Meta. Elle ne mesure ni les ventes ni la déduplication.
- Les événements serveur exigent quand même une base légale et le respect du consentement. Consultez un conseiller juridique pour la Loi 25 ou le RGPD.
- L’API Conversions améliore la qualité du signal. Elle ne garantit pas plus de conversions.

Qu’est-ce que l’API Conversions?
L’API Conversions de Meta (CAPI), qu’on appelle encore souvent l’API Conversions de Facebook, permet à votre serveur d’envoyer directement à Meta des événements Web, d’application ou hors ligne. Elle complète le pixel Meta, qui envoie le même genre d’événements à partir du navigateur du visiteur.
Le pixel dépend du navigateur. Bloqueurs de publicité, protections de confidentialité, pages lentes et onglets fermés trop vite peuvent bloquer une partie de ses requêtes. Un événement serveur échappe en bonne partie à ces limites : Meta peut donc recevoir des événements que le pixel a manqués, et vous contrôlez mieux ce que vous envoyez.
Meta recommande d’utiliser les deux ensemble. Le serveur ajoute de la fiabilité et des données que vous seul détenez, comme la valeur confirmée d’une commande. Les deux alimentent le même ensemble de données dans le Gestionnaire d’événements. La référence complète se trouve dans la documentation de l’API Conversions de Meta (en anglais).
Vous avez une boutique Shopify et voulez le portrait global du suivi côté serveur (GA4, Google Ads, gestion du consentement)? Lisez notre guide du suivi côté serveur pour Shopify. Cet article-ci se concentre sur Meta.
Les options d’installation
Il existe quatre façons courantes d’envoyer des événements à l’API Conversions : une intégration partenaire, la passerelle de l’API Conversions, Google Tag Manager côté serveur ou une intégration directe. Le bon choix dépend de votre plateforme, de votre équipe et du niveau de contrôle voulu.
| Option | Fonctionnement | Effort | Idéale pour | À surveiller |
|---|---|---|---|---|
| Intégration partenaire | Une application envoie les événements serveur pour vous, comme l’application Facebook et Instagram de Shopify ou l’intégration Meta de WooCommerce | Faible, sans code | Les boutiques sur une plateforme compatible | Peu de contrôle sur les événements et les paramètres; vérifiez le réglage de partage de données qui active les événements serveur |
| Passerelle de l’API Conversions | Un service de Meta, configuré depuis le Gestionnaire d’événements, hébergé sur votre infonuagique ou chez un partenaire, qui relaie vos événements du pixel par le serveur | Faible à moyen | Les sites sans intégration partenaire, avec peu de code | Conçue autour des événements du pixel; vous payez l’hébergement et gérez les mises à jour |
| GTM côté serveur | Un conteneur serveur Google Tag Manager reçoit les événements et une balise Meta les envoie à l’API | Moyen à élevé | Les équipes qui utilisent déjà GTM et veulent un seul flux pour Meta, GA4 et Google Ads | Il faut quelqu’un pour bâtir, tester et maintenir les deux conteneurs et l’hébergement |
| Intégration directe | Votre propre système appelle le point de terminaison de l’API Conversions avec un jeton d’accès | Élevé | Les plateformes sur mesure, les CRM et les événements hors ligne | Du développement pour le hachage, les tentatives, la déduplication et les versions de l’API |
Sur Shopify, commencez par l’application Facebook et Instagram avant de bâtir quoi que ce soit sur mesure. Passez à GTM côté serveur ou à une intégration directe quand l’application ne suffit plus.
La déduplication des événements
La déduplication permet à Meta de garder une seule copie d’un événement envoyé par le pixel et par le serveur. Pour que ça fonctionne, les deux copies doivent avoir le même event_name et le même identifiant : eventID côté pixel et event_id côté serveur.
Générez l’identifiant une seule fois, au moment de l’action, et transmettez-le aux deux chemins (un numéro de commande convient pour un achat). Ne laissez pas le serveur créer un nouvel identifiant à chaque nouvelle tentative : chaque tentative aurait l’air d’un nouvel événement.
Les noms d’événements doivent être identiques. Purchase et purchase sont deux événements différents. La documentation de Meta prévoit aussi une fenêtre de temps pour jumeler les copies navigateur et serveur : envoyez donc les événements serveur rapidement plutôt qu’en lots tardifs. Consultez le guide de déduplication de Meta (en anglais) pour les règles à jour.
Informations client et qualité de correspondance
Les paramètres d’informations client aident Meta à associer un événement serveur à la personne qui a vu votre publicité. La qualité de correspondance des événements (Event Match Quality, ou EMQ) est la note de 0 à 10 que le Gestionnaire d’événements affiche pour indiquer à quel point ces paramètres permettent d’associer les événements à des comptes Meta.
Les paramètres courants sont le courriel (em), le téléphone (ph), le prénom et le nom, la ville, la province ou l’État, le code postal, le pays et l’external_id. Vous devez normaliser ces valeurs (retirer les espaces, tout mettre en minuscules, garder seulement les chiffres avec l’indicatif du pays pour le téléphone), puis les hacher en SHA-256 avant l’envoi.
Certains paramètres s’envoient sans hachage : l’adresse IP du client, l’agent utilisateur et les valeurs fbp et fbc tirées des témoins de Meta dans le navigateur. Pour les événements Web, Meta exige client_user_agent et event_source_url, ainsi qu’un action_source égal à website. La liste complète se trouve dans la référence des paramètres d’informations client (en anglais).
Sachez ce que la qualité de correspondance ne mesure pas. Elle ne vérifie pas que la déduplication fonctionne, que la valeur des achats est juste, que chaque commande est envoyée, ni que vos publicités génèrent des ventes. Une bonne note avec des achats en double, c’est quand même un suivi brisé. Et le hachage n’est pas de l’anonymisation : il vous faut toujours une base légale pour partager ces données.
Événements standards et paramètres
Utilisez les noms d’événements standards de Meta chaque fois qu’ils s’appliquent, et envoyez les paramètres qui permettent à Meta d’optimiser et de rapporter la valeur.
Commerce en ligne. L’entonnoir habituel est ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo et Purchase. Envoyez value et currency avec chaque achat, ainsi que content_ids ou contents et content_type pour que les événements correspondent à votre catalogue dans les publicités dynamiques. Décidez si la valeur inclut les taxes et la livraison, et tenez-vous-en à cette règle.
Génération de prospects. Utilisez Lead pour les formulaires, CompleteRegistration pour les inscriptions, Schedule pour les rendez-vous réservés et Contact pour les appels ou le clavardage. Si vous qualifiez vos prospects dans un CRM, le chemin serveur permet d’envoyer un événement plus tard, quand un prospect devient client, avec une valeur d’action_source comme system_generated lorsqu’elle s’applique.
L’événement serveur lui-même exige event_name, event_time (un horodatage Unix), action_source et user_data. Meta refuse les événements dont l’event_time est trop ancien : ne gardez pas vos événements Web en file d’attente pendant des jours. Consultez la référence des paramètres d’événements serveur (en anglais) pour les limites.
Consentement, Loi 25 et RGPD
Passer par un serveur n’efface pas les obligations de consentement. Si un visiteur refuse le suivi publicitaire, le chemin serveur doit respecter ce choix comme le pixel.
Concrètement, transmettez l’état du consentement de votre bannière à chaque chemin. Côté navigateur, le pixel accepte fbq('consent', 'revoke') et fbq('consent', 'grant'). Côté serveur, votre code ou votre conteneur doit vérifier le consentement avant d’envoyer ou d’enrichir un événement.
Au Québec, la Loi 25 encadre le consentement, la transparence et la communication de renseignements personnels à l’extérieur de la province. En Europe, le RGPD et les règles ePrivacy s’appliquent. Cet article ne constitue pas un avis juridique. Faites valider par un conseiller juridique ce que vous recueillez, pourquoi, qui le reçoit et combien de temps vous le conservez avant d’envoyer des données client à Meta.
Tester dans le Gestionnaire d’événements
Testez chaque événement dans le Gestionnaire d’événements avant de vous y fier. L’onglet Événements test affiche les événements navigateur et serveur presque en temps réel, et l’onglet Diagnostics liste les erreurs et avertissements une fois le trafic réel en place.
Pour les événements serveur, copiez le code de test de l’onglet Événements test et envoyez-le dans le champ test_event_code. Déclenchez ensuite chaque action sur votre site, de la fiche produit à la commande test ou au formulaire. Vérifiez que chaque événement arrive du navigateur et du serveur, avec le même identifiant, la bonne valeur et la bonne devise, et les informations client attendues.
Retirez le code de test avant la mise en ligne. Ensuite, surveillez l’onglet Diagnostics : doublons, paramètres manquants, hachages invalides, baisse de volume. Les problèmes surgissent souvent après une mise à jour du thème ou de la bannière de consentement.
Comment lire les résultats
L’API Conversions améliore le signal que Meta reçoit. Elle ne garantit ni plus de conversions, ni des coûts plus bas, ni un meilleur rendement publicitaire.
Après la mise en place, le Gestionnaire de publicités peut afficher plus de conversions. Une partie peut venir d’événements que le pixel manquait, pas de nouvelles ventes. Comparez les chiffres de Meta avec votre propre source de vérité (commandes Shopify, prospects dans le CRM) sur la même période. Attendez-vous à des écarts : fenêtres d’attribution, conversions modélisées, fuseaux horaires et remboursements diffèrent d’un système à l’autre.
Un meilleur signal peut aider la diffusion avec le temps. Mais c’est encore la publicité elle-même qui fait l’essentiel du travail. Si le suivi est propre et que les résultats stagnent, regardez votre offre et vos créatifs. Notre article sur la diversité créative sur Meta explique comment les tester.
La liste de contrôle
Suivez ces étapes dans l’ordre. Sauter les deux premières cause la plupart des problèmes.
- Listez chaque pixel, application et balise qui envoie des événements à Meta, et éliminez les doublons.
- Notez les événements dont vous avez besoin, leur nom exact, leurs paramètres et la source de l’identifiant d’événement.
- Choisissez une option : intégration partenaire, passerelle de l’API Conversions, GTM côté serveur ou intégration directe.
- Reliez le consentement de votre bannière au pixel et au chemin serveur.
- Envoyez le même
event_nameet le même identifiant par les deux chemins. - Ajoutez des informations client normalisées et hachées, ainsi que l’adresse IP, l’agent utilisateur,
fbpetfbclorsque c’est permis. - Testez chaque événement avec
test_event_codedans l’onglet Événements test. - Mettez en ligne, puis surveillez les Diagnostics et la qualité de correspondance pendant la première semaine.
- Comparez chaque mois les conversions Meta avec vos commandes ou vos prospects.
Les erreurs fréquentes
La plupart des problèmes viennent d’événements en double ou mal jumelés, pas de l’API elle-même :
- Deux applications ou balises qui envoient le même achat, que Meta compte alors deux fois.
- Des identifiants différents, ou aucun identifiant, sur les copies navigateur et serveur.
- Un courriel ou un téléphone envoyé sans hachage, ou haché avant d’être normalisé.
- Un achat sans
valueou sanscurrency, ou des devises mélangées. - Des événements serveur envoyés alors que le visiteur a refusé le consentement.
- Un
test_event_codeoublié après les tests. - Juger le succès seulement par la qualité de correspondance ou par les chiffres du Gestionnaire de publicités.
Vous voulez un deuxième regard sur votre installation? Notre équipe Data audite et met en place le suivi Meta, et notre équipe Publicité gère les campagnes qui s’en servent. Vous pouvez aussi réserver un appel gratuit de 30 minutes pour revoir votre Gestionnaire d’événements ensemble.
Vous diffusez des publicités Meta sur cette base? Voyez notre agence de publicité Facebook et Meta.
Questions fréquentes
L’API Conversions de Facebook et celle de Meta, c’est la même chose?
Oui. C’est le même produit. Facebook a renommé sa société mère Meta en 2021 et l’API a gardé le même fonctionnement sous le nouveau nom. Les deux termes désignent les événements envoyés par votre serveur vers un ensemble de données Meta.
Faut-il garder le pixel Meta si on utilise l’API Conversions?
Dans la plupart des cas, oui. Meta recommande une configuration redondante : le pixel envoie les événements depuis le navigateur, l’API Conversions envoie les mêmes depuis votre serveur, et la déduplication n’en garde qu’une copie.
L’API Conversions va-t-elle augmenter mes conversions?
Pas à elle seule. Elle peut aider Meta à recevoir et à associer une plus grande part des conversions qui ont déjà lieu. Plus de conversions déclarées, c’est un changement de mesure, pas la preuve de plus de ventes. Comparez avec vos propres commandes ou demandes pour juger l’effet réel.
Faut-il un développeur pour installer l’API Conversions?
Pas toujours. Une intégration partenaire, comme l’application Facebook et Instagram de Shopify, se fait sans code. La passerelle de l’API Conversions demande un peu de configuration infonuagique. Google Tag Manager côté serveur et une intégration directe demandent des compétences techniques pour les bâtir et les maintenir.
Qu’est-ce qu’un bon score de qualité de correspondance des événements?
Meta note la qualité de correspondance de 0 à 10 pour chaque événement. Plus c’est haut, mieux c’est, mais ce score indique seulement à quel point vos informations client permettent d’associer les gens à des comptes Meta. Il ne vérifie ni la déduplication, ni la valeur des achats, ni l’effet réel de vos publicités sur les ventes.

