Contact ventesEssayer gratuitement

Comment configurer l'API conversion de Facebook + Déduplication d’événements et Données utilisateur de hachage

Ira Holubovska

Ira Holubovska

Auteur
Mis à jour
21 août 2025
Publié
11 févr. 2021
Egalement disponible

Facebook Pixel permet de suivre ce que font les utilisateurs sur votre site, de constituer des audiences de remarketing et de créer des lookalikes. Si le pixel Facebook est bien implémenté, il enverra des informations pertinentes aux algorithmes d’apprentissage automatique de Facebook. Ces algorithmes utiliseront les données du pixel pour montrer vos publicités aux personnes les plus susceptibles de convertir.

Depuis plusieurs années, nous pouvions suivre des événements sur le site via du code JavaScript, le SDK Facebook dans les applications, ou téléverser des événements hors ligne. Mais comment suivre les utilisateurs qui ont installé un bloqueur de pubs ou suivre des événements en dehors du site. Ou comment prolonger la durée de vie des cookies. Cela peut se faire soit avec Facebook Conversions API, soit avec Facebook Conversions API Gateway.

Cet article se concentre sur le suivi de conversion Facebook et montre comment configurer Facebook Conversions API via le conteneur serveur de Google Tag Manager. Au passage, consultez les modèles préconfigurés de Stape pour Meta CAPI. C’est plus simple que jamais de configurer votre setup, tout est prêt pour vous.

Qu’est-ce que l’API de conversions de Facebook ?

Voyons ce qu’est la Facebook Conversions API et comment l’utiliser pour améliorer le suivi des événements, l’attribution et la collecte des données sur Facebook. Facebook Conversions API permet d’envoyer n’importe quel événement depuis votre serveur vers le serveur de Facebook.

Facebook CAPI a le même objectif que Facebook Pixel, mais la technologie est différente. Les politiques et restrictions rendent CAPI plus adapté au contexte actuel du suivi. Avec la Facebook Conversions API, le navigateur de l’utilisateur n’est pas utilisé pour l’envoi des informations de suivi. Tout passe par le serveur cloud. Les données des utilisateurs deviennent plus sûres et plus précises.

Si l’on regarde de près le lien des publicités Facebook, on voit qu’à la fin de presque toute URL Facebook ajoute le paramètre fbclid. Le code du pixel sur la page d’atterrissage stocke la valeur de ce paramètre dans un cookie puis l’envoie avec tout événement Facebook. En plus de l’identifiant de clic fbclid, Facebook utilise l’identifiant de navigateur fbp. Les cookies fbp et fbc aident Facebook à déterminer quel type d’utilisateur a atterri sur votre site et qui a converti.

Facebook peut aussi faire correspondre les utilisateurs grâce à d’autres paramètres comme l’email, le numéro de téléphone, le prénom et le nom, etc. Plus vous envoyez de données utilisateur à la Facebook Conversions API, plus le taux de correspondance est élevé.

Quels sont les principaux avantages de Facebook Conversions API.

Le suivi côté serveur Facebook, ou Facebook Conversions API, existe depuis quelques années. Mais à partir de 2021, Facebook a fortement poussé l’adoption de Conversions API. Si vous avez un représentant Facebook dédié pour votre compte publicitaire, il vous recommandera très probablement de configurer Facebook Conversions API.

Voici les raisons principales d’envisager l’implémentation de la Facebook Conversions API. Les détails se trouvent sous l’infographie.

Avantages de l’API de conversions de Facebook
  1. Cela peut vous aider à suivre les utilisateurs qui ont installé un bloqueur de publicités, ceux qui utilisent Safari ou un autre navigateur avec prévention intelligente du suivi, ou encore les personnes qui ont refusé le suivi Facebook sur iOS 14, iOS 15. C’est possible parce que les requêtes partent d’un serveur et non du navigateur de l’utilisateur. Les cookies tiers ne seront pas bloqués. Avec les paramètres utilisateur que vous envoyez avec les événements CAPI, Facebook fait correspondre les événements aux utilisateurs de sa base. Vous obtenez des données plus fiables.
  2. Une durée de vie des cookies prolongée. Avec la Facebook Conversions API, vous prolongez la durée de vie des cookies Facebook à 6 mois. Sans Facebook Conversions API, Safari limite la durée de vie des cookies à 1 à 7 jours.
  3. Conversions API vous donne plus de contrôle sur vos données et une meilleure compréhension du parcours client.
  4. Vous pouvez utiliser Facebook Conversions API pour suivre des événements qui ne se produisent pas sur le site. Par exemple, les appels téléphoniques ou les ventes hors ligne.

Exemple réel de la valeur de Meta Conversions API

En combinant Conversions API avec Meta Pixel, Ray-Ban a nettement amélioré ses résultats publicitaires. L’ensemble a permis une portée supérieure de 36% sur Facebook et Instagram par rapport à l’utilisation de Meta Pixel seul.

Résultats de l’étude de cas Ray-Ban

La marque a aussi constaté une baisse de 19% du coût pour 1 000 vues et une baisse de 7% du coût par conversion, ce qui montre l’efficacité de Conversions API pour optimiser les campagnes et obtenir de meilleures performances.

Façons de configurer le suivi côté serveur Facebook

En utilisant Meta Conversions API Gateway

Meta Conversions API Gateway est la solution la plus rapide pour mettre en place le suivi côté serveur avec Meta, sans besoin de compétences techniques spécifiques.

Comment fonctionne Conversions API Gateway

La fonction essentielle de Conversions API Gateway est son environnement. Chaque instance de Conversions API Gateway nécessite un serveur cloud pour gérer toutes les communications entre Meta Pixel et Conversions API. Consultez la documentation Meta qui explique en détail le fonctionnement de Conversions API Gateway.

Une fois Meta Pixel connecté à l’environnement Conversions API Gateway, il utilisera les événements web pour suivre les données depuis le serveur. Par conséquent, avant d’implémenter Conversions API Gateway, il est essentiel de s’assurer que les événements web sont corrects à 100% et reçoivent toutes les informations requises sur l’utilisateur et le produit.

Avec Stape, la configuration et l’hébergement de Conversions API Gateway sont plus simples que jamais. Il suffit de créer un compte Stape et de configurer Conversions API Gateway dans Stape. Ensuite, connectez les Meta Pixels requis à l’environnement Conversions API Gateway.

Avantages et inconvénients de Conversions API Gateway

Avantages:

1. Prix bas. L’hébergement Stape pour Conversions API Gateway coûte 10 $/mois par pixel ou 100 $/mois pour 100 pixels. Nous proposons également un essai gratuit de 7 jours.

De plus, Conversions API Gateway est la voie la plus simple pour mettre en place Conversions API, ce qui peut vous faire économiser des centaines ou des milliers de dollars par rapport à une implémentation manuelle.

2. Mise en place facile. Vous n’avez pas besoin d’embaucher des développeurs ou des spécialistes du tracking pour configurer Conversions API Gateway. Les étapes sont simples par rapport à une implémentation de la Conversion API ; cela peut prendre moins d’une minute et peut être fait par une personne sans compétences techniques.

3. Aucune maintenance. Les mises à jour de Conversions API Gateway s’installent automatiquement. Inutile de passer du temps à mettre à jour des paramètres ou des serveurs. Même quand vous ajoutez un nouvel événement, vous avez seulement à mettre en place le suivi web correct et Conversions API Gateway commencera à envoyer les événements depuis le serveur automatiquement.

Inconvénients:

1. Nouveauté. Conversions API Gateway est récent, Meta va probablement déployer de nouvelles fonctions et mettre à jour l’existant, il faut donc s’attendre à des changements.

2. Pas de support pour d’autres plateformes. Si vous voulez tous les bénéfices du suivi côté serveur, le conteneur serveur de Google Tag Manager peut être un meilleur choix. Vous aurez quand même besoin d’une instance de Google Tag Manager pour gérer Google Analytics serveur, Google Ads, etc.

Hébergement Stape pour Conversions API Gateway

Stape propose l’hébergement pour Conversions API Gateway, au prix de 10$ par pixel par mois ou 100$ pour 100 pixels par mois. Tous les utilisateurs disposent d’un essai gratuit de 7 jours.

Tarifs Stape CAPIG

Comment configurer Meta Conversions API Gateway

Pour configurer Conversions API Gateway avec Stape, vous devez:

  1. Créer un compte Stape si vous n’en avez pas.
  2. Connecter le hub Conversions API Gateway à Meta Pixel.

Une fois le conteneur Conversions API Gateway créé sur Stape, nous créons une pile CloudFormation Amazon Web Services suivant les exigences de Meta. Nous gérons aussi toutes les mises à jour.

Pour un guide pas à pas, consultez notre article sur la configuration de Meta Conversions API Gateway.

Consultez aussi notre article qui compare Meta CAPI et Meta CAPIG pour choisir la bonne solution selon vos besoins.

Utiliser le conteneur serveur GTM

Une des méthodes les plus accessibles est d’utiliser Google Tag Manager côté serveur. Avec sGTM, les entreprises peuvent envoyer les données clients directement vers les serveurs de Facebook.

Avantages de la configuration de Facebook CAPI via sGTM:

  • Options de personnalisation flexibles.
  • Possibilité d’implémenter un tracking côté serveur pur ou hybride web plus serveur.
  • Opportunité d’enrichissement des données.

Inconvénients de la configuration de Facebook CAPI via sGTM:

  • Connaissances techniques requises sur le conteneur serveur de Google Tag Manager.
  • Besoin d’une infrastructure cloud pour héberger sGTM.

Dans cet article, nous nous concentrons sur la configuration du suivi côté serveur Facebook via le conteneur serveur GTM.

Comment configurer Facebook Conversions API avec le conteneur serveur GTM ?

Nous allons utiliser le conteneur serveur de Google Tag Manager pour configurer Facebook Conversions API. Vous aurez besoin de:

Nous avons aussi un article sur le conteneur serveur Tag Manager et ses avantages.

Cette vidéo montre comment configurer Facebook Conversions API avec Google Analytics 4.

Étapes pour configurer Facebook Conversions API

2. Envoyez les données vers le conteneur serveur GTM. Les méthodes les plus utilisées sont Google Analytics 4 et Data Client de Stape.

3. Ouvrez votre conteneur serveur Google Tag Manager. Ajouter le tag Facebook Conversions API depuis la Template Gallery.

Tag Facebook Conversions API pour serveur GTM

4. Créez un tag Facebook Conversions API dans sGTM. Choisir Tag, puis Nouveau, puis le Facebook Tag ajouté à l’étape précédente.

Ajoutez votre Facebook Pixel ID et votre Facebook API Access Token. Nous recommandons d’ajouter ces valeurs comme variables, car vous en aurez besoin pour chaque événement Facebook que vous souhaitez suivre. Si vous ne connaissez pas votre Facebook API Access Token, cette documentation vous aidera à le trouver.

Le tag Facebook Conversions API hérite du client

5. Vous avez deux options pour configurer notre tag Facebook Conversions API:g: 

  • Override. Dans ce cas, vous devrez configurer les événements Facebook manuellement. Nous verrons comment configurer manuellement les événements du serveur Facebook à l’étape six. C’est l’option préférée ; elle demande plus de temps et de compétences. Avec cela vous contrôlez complètement la charge utile des événements, vos événements web Facebook et vos événements serveur Facebook seront identiques.
  • Inherit from client. Dans ce cas, le tag fera correspondre la charge utile des événements GA4, Data aux événements standards de Facebook. Si le tag ne peut pas faire correspondre l’événement GA à un événement standard Facebook, il l’enverra comme événement personnalisé. Tout est automatique ; vous n’avez pas à configurer les événements Facebook.

6. Si vous avez choisi l’option override, utilisez les événements GA4 ou Data Tag, Data Client pour déclencher les événements serveur Facebook. L’événement Facebook pageview doit se déclencher sur un événement personnalisé page_view revendiqué par un client spécifique. Par exemple, si vous choisissez GA4 comme source de données pour le conteneur serveur GTM, utilisez l’événement page_view quand le nom du client est GA4.

Pour configurer d’autres événements, ouvrez le mode aperçu sGTM, faites l’action à suivre sur votre site, puis vérifiez le nom de l’événement que GA4 ou Data Tag envoie à votre conteneur serveur.

Dans la capture ci-dessous, nous voulons configurer l’événement Facebook ViewContent quand quelqu’un ouvre la page produit sur notre site. Assurez-vous d’envoyer avec votre événement GA4, Data depuis le conteneur web les données supplémentaires à utiliser pour l’événement serveur. L’exemple ci-dessous utilise aussi les paramètres e-commerce standards de Facebook et les données utilisateur.

Pour cela, nous avons créé un nouveau tag dans le conteneur serveur, choisi override, sélectionné l’événement standard ViewContent, ajouté l’API Access Token et le Facebook Pixel ID. Nous avons aussi ajouté les User Data. Puis nous avons créé un nouveau déclencheur avec event name égal à view_item et Client Name égal à GA4.

Méthode de configuration du nom de l'événement
Trigger config

7. Vous pouvez passer des paramètres personnalisés avec Server Event Data Override, User Data et Custom Data. Vous pouvez envoyer des données utilisateur pour augmenter le score de correspondance sur Facebook via User Data, notez que les informations utilisateurs envoyées à Facebook Conversions API doivent être hachées. Notre tag Facebook hache automatiquement les données nécessaires.

Vous pouvez aussi activer Event Enhancement pour utiliser un cookie sécurisé HTTP-only gtmeec afin d’enrichir les données d’événement. Quand cette option est activée, le tag stocke les données utilisateur dans des cookies et enrichit les événements quand ces données ne sont pas disponibles. Cela améliore la qualité de correspondance des événements et donc l’attribution des conversions aux campagnes.

Enable Event Enhancement dans Facebook CAPI tag

8. Quand vous avez fini de configurer tous vos événements Facebook, ouvrez le mode aperçu de Google Tag Manager et testez le bon fonctionnement. Vous pouvez aussi ouvrir votre tag Facebook dans le conteneur serveur et ajouter un Facebook test ID. Vous trouvez ce test ID dans Facebook Events Manager sous l’onglet Test events.

Testez Facebook Conversions API

9. Une fois que vous avez configuré et vérifié que Facebook Conversions API fonctionne correctement, vous devez supprimer le tracking du navigateur Facebook ou configurer la déduplication des événements. Sinon vos événements seront dupliqués.

Testez Facebook CAPI dans Google Tag Manager serveur

2.1 Utilisez l’outil de débogage serveur GTM pour vérifier que le code de base et les événements Facebook se déclenchent correctement.

La première étape de test du suivi côté serveur Facebook est la même que pour Google Analytics. Vous devez vérifier que les événements se déclenchent sur les bons déclencheurs. Ouvrez l’outil de débogage GTM, parcourez les pages de votre site et effectuez les événements à tester. Ensuite, allez dans l’onglet du débogueur Tag Manager et vérifiez les résultats.

D’abord, assurez-vous que le pixel Facebook de base se déclenche sur un pageview. Si le statut du tag est Fail, vérifiez les requêtes sortantes. Elles indiquent la raison de l’échec.

Testez le tag Facebook CAPI dans le serveur Google Tag Manager

Si vous utilisez notre tag de suivi Facebook côté serveur, vous avez deux options pour envoyer les événements Facebook:

  • Inherit. Dans ce cas, nous faisons correspondre automatiquement les événements GA aux événements standards Facebook. Si vous utilisez inherit, vous verrez seulement le tag de base Facebook dans le mode débogage de GTM.
  • Override. L’option override demande de configurer manuellement les événements serveur Facebook dans le conteneur serveur. Ils seront visibles dans le mode débogage du serveur.

2.2 Outil de test Facebook pour Facebook Conversions API

Ouvrez Events Manager dans votre Business Manager Facebook et cliquez sur Test events. Vous verrez un code test event à ajouter à notre Facebook Tag dans Google Tag Manager. Grâce à ce code, vous pourrez tester les événements du serveur Facebook en temps réel.

Une fois le test ID ajouté, ouvrez votre site et effectuez les actions qui déclenchent vos événements Facebook. Revenez ensuite à l’outil de test Facebook et vérifiez les événements affichés. Dans la colonne Received From, vous devez voir Server. Vous pouvez cliquer sur l’événement et voir les paramètres enregistrés.

Outil de test de déduplication des événements Facebook

Notez que l’extension Chrome Facebook Pixel Helper, utilisée pour vérifier les événements du navigateur, ne marche pas pour Conversions API. Il faut tout vérifier dans l’outil de test.

2.3 Vérifiez que les cookies Facebook ont été prolongés

Note: les cookies ne seront prolongés que si vous utilisez un sous-domaine personnalisé dans l’URL de tagging. Par exemple, si l’URL de votre site est example.com, alors le domaine personnalisé du serveur de tagging doit ressembler à gtm.example.com.

La troisième étape est similaire à ce que nous avons fait avec quelques différences. Pour vérifier la date d’expiration des cookies Facebook, vous devez d’abord la générer. Pour cela, ouvrez votre site et ajoutez fbclid.

Ensuite, ouvrez les outils développeur, allez dans Storage, puis dans Cookies. Vérifiez que _fbc et _fbp ont été prolongés.

Vérifier les cookies fbp et fbc

Modèles et guides préconstruits pour votre plateforme

Avec Stape, vous pouvez améliorer la précision du tracking et les résultats des campagnes grâce au suivi côté serveur.

Selon votre plateforme, vous pouvez mettre en place le suivi rapidement et efficacement avec nos modèles personnalisés. Suivez les guides pas à pas pour configurer Meta CAPI avec le conteneur serveur GTM pour:

Des modèles et guides pour Wix, Shopware, Prestashop et d’autres arrivent bientôt. Dites-nous si vous avez besoin d’un modèle pour un autre CMS.

Déduplication d’événements entre Facebook Pixel et Conversions API

Facebook recommande d'utiliser à la fois Pixel et Conversions API pour suivre les événements, mais sans déduplication des événements, les données dupliquées provenant du navigateur et du serveur peuvent fausser les résultats. La déduplication garantit qu'un seul événement est conservé en utilisant des identifiants d'événements uniques partagés entre les deux sources. Une configuration correcte nécessite la génération et la synchronisation de ces identifiants entre les événements du navigateur et du serveur, ce qui peut être testé dans le Gestionnaire d'événements de Facebook.

De plus, l'envoi de données utilisateur via l'API Conversions améliore la qualité des correspondances et les scores de correspondance des événements, ce qui optimise les performances publicitaires. Les données utilisateur doivent idéalement provenir d'une couche de données et respecter les politiques de confidentialité. Des outils tels que les plugins Stape simplifient l'intégration des données utilisateur pour une meilleure optimisation des campagnes Facebook.

Envoyer les paramètres utilisateur à l'aide de l'API Facebook Conversions

Pour faire correspondre les visiteurs de votre site à leur base, Facebook utilise des User Data pour la Conversion API.

Facebook exige de hacher certains paramètres avant envoi, mais vous n’avez pas à vous en soucier, le tag Facebook hache automatiquement les données nécessaires avant l’envoi. 

Plus vous envoyez de paramètres utilisateur à Facebook, plus la probabilité de correspondance est élevée et plus votre event match score augmente.

L’envoi des paramètres utilisateur depuis votre site vers Facebook est un sujet sensible, car vous partagez des données des utilisateurs avec un service tiers. Avant d’envoyer ces données à Facebook, assurez-vous qu’elles respectent votre politique de confidentialité.

Idéalement, vous ajoutez les données utilisateur au data layer, mais si ce n’est pas possible, collectez-les depuis la page avec du code JavaScript personnalisé et envoyez-les avec les conversions ou événements souhaités. 

Par exemple, tous les plugins Stape pour CMS, comme Facebook CAPI for Shopify, WordPress server-side tracking, Magento 2 Google Tag Manager, l’app GTM pour BigCommerce, ajoutent un data layer qui contient aussi des données utilisateur.

Vous pouvez donc les récupérer facilement depuis le data layer et les ajouter aux événements Facebook dans le conteneur web:

Configuration de la balise Facebook Pixel

Puis transférer les données nécessaires vers le conteneur serveur, dans la charge utile GA4 ou Data Tag selon ce que vous utilisez:

Configuration de la balise Facebook Pixel

Et enfin ajouter ces données à votre événement Facebook côté serveur:

Configuration de la balise Facebook Pixel

Ainsi vous obtiendrez une meilleure qualité de correspondance pour vos événements Facebook et, potentiellement, de meilleures performances de vos campagnes publicitaires, car Facebook comprendra mieux votre audience et optimisera mieux vos campagnes.

Comment vérifier s’il existe des erreurs pixel Facebook ou Conversions API

L’Events Testing Tool de Facebook est un outil puissant qui permet de déboguer et de résoudre les problèmes avec vos pixels Facebook ou vos événements serveur. En cas d’erreurs, elles apparaissent dans l’onglet Diagnostics pour analyse.

Les erreurs en rouge nécessitent une action rapide et doivent être corrigées immédiatement. Les erreurs en jaune sont des avertissements non critiques ; vous devez les surveiller et les traiter ensuite.

Facebook permet de marquer les problèmes comme résolus ou ignorés. Si vous marquez une erreur comme résolue et qu’elle réapparaît, Facebook la réaffichera dans 3 jours. Les problèmes ignorés vont dans la section Ignored et y restent.

Quand vous corrigez un problème de tracking Facebook, je vous conseille de le marquer comme résolu. Vous signalez ainsi à Facebook que le problème est corrigé, et vous serez alerté si l’erreur revient.

Quelles sont les erreurs les plus fréquentes sur Pixel Facebook et Conversions API, et comment les corriger?

1. Nouveaux domaines qui envoient des données

Nouveaux domaines qui envoient des données

Vous pouvez voir tous les domaines qui envoient des données à votre pixel Facebook. Si Facebook détecte du trafic depuis un nouveau domaine ou un sous-domaine, la plateforme envoie un avertissement. Vous pouvez mettre des domaines en liste blanche ou en liste noire. Cette fonction permet de bloquer le trafic de vos sites de test ou des URL techniques.

Vous verrez très probablement aussi du trafic depuis gtm-msr.appspot.com. Cela peut arriver quand vous exécutez un conteneur en mode débogage ou publication, ou quand des utilisateurs arrivent sur votre site avec JavaScript désactivé, par exemple des bots.

Pour créer des listes d’autorisation ou de blocage de domaines, ouvrez Events tools dans Business Manager, cliquez sur Settings, puis faites défiler jusqu’à Traffic Permissions.

Créez une liste d’autorisation et de blocage dans Facebook

2. L’événement ne contient pas certains paramètres de déduplication

L’événement ne contient pas certains paramètres de déduplication

C’est la seconde erreur Facebook CAPI la plus fréquente selon mon expérience. Elle signifie que vous n’envoyez pas certaines clés de déduplication pour vos événements serveur. Facebook utilise ces clés de déduplication: le nom d’événement, l’ID d’événement, _fbp et l’external ID.

Paramètres de déduplication des événements

D’après mon expérience, les paramètres Event ID causent cette erreur dans 80% des cas. Vérifiez que vous envoyez un Event ID pour Facebook Pixel et pour Facebook Conversions API. Cet ID doit être le même pour l’événement navigateur et l’événement serveur. Facebook verra alors le même nom et le même ID d’événement et commencera la déduplication.

Par exemple, pour les événements PageView, envoyez le même Event ID et le même nom depuis Facebook Pixel et depuis Facebook CAPI.

Pour tester l’Event ID, ouvrez l’outil de test d’événements Facebook. Si tout est correct, vous devriez voir quelque chose de similaire à la capture. Facebook y montre les PageView enregistrés depuis le navigateur et depuis le serveur. Ces événements avaient le même Event ID, Facebook a donc traité les événements navigateur et dédupliqué les événements serveur.

Outil de test de déduplication des événements Facebook

Mais il peut y avoir un autre cas où vous voyez des événements de navigateur et de serveur déclenchés de façon aléatoire. Dans ce cas, vérifiez l’Event ID Facebook ; ces identifiants ne sont probablement pas identiques. Vous pouvez utiliser notre variable personnalisée pour le conteneur web afin de définir l’Event ID Facebook. Consultez aussi la section ci-dessus sur la déduplication Facebook.

Parfois, cette erreur est due à l’oubli de supprimer le Facebook test ID avant de publier les tags Facebook CAPI en production. Je recommande de configurer le Test ID comme variable de table de recherche qui ne fonctionne que quand le mode débogage est vrai.

Créer un identifiant de test Facebook dans Google Tag Manager

3. Le serveur envoie des paramètres Invalid Match Key pour l’événement PageView

Le serveur envoie des paramètres Invalid Match Key

Ici, Facebook vous signale que les valeurs envoyées depuis le serveur ne sont pas uniques ou mal formatées. Par exemple, vous pourriez envoyer une IP utilisateur qui contient des symboles au lieu de chiffres uniquement, ou vous avez sélectionné la mauvaise variable, comme un numéro de téléphone dans le champ email.

Pour vérifier le problème, ouvrez le mode aperçu du conteneur serveur et du conteneur web Google Tag Manager si vous avez utilisé GTM pour configurer Facebook Conversions API. Vous devez voir quels paramètres utilisateur ont été envoyés à Facebook et s’ils sont bien formatés. Testez l’événement, cliquez sur le tag dans le mode débogage, puis sur values.

userDataList dans Tag Details

Cette erreur peut aussi indiquer qu’un paramètre manque ou est mal formaté.

Par exemple, j’ai eu un client qui voulait envoyer le pays et la ville de l’utilisateur à partir de l’adresse IP. Facebook s’attend à voir les vraies coordonnées saisies par l’utilisateur sur le site et non celles déduites automatiquement de l’IP. Cette configuration a aussi généré une erreur de paramètres invalides.

4. Données personnelles potentiellement sensibles envoyées à Facebook

Données personnelles potentiellement sensibles envoyées à Facebook

Cette erreur concerne généralement les événements du navigateur et signifie que Facebook a détecté des données utilisateur dans l’URL. Certains CMS et outils comme Calendly ou PayPal envoient des détails utilisateur dans l’URL après une inscription ou un achat.

Cette erreur est difficile à corriger ; c’est le travail de vos développeurs. Ils doivent améliorer les paramètres de requête de l’URL et supprimer toute information personnelle de l’URL. Sinon, vous pouvez suivre les instructions de ce post GitHub et essayer de corriger le problème dans GTM. Autre solution : passer au suivi Facebook côté serveur uniquement. Ainsi, vous pouvez modifier l’URL avant de l’envoyer à Facebook.

5. Améliorer la “event match quality” des événements

Qualité des matchs événementiels Facebook

Pour chaque événement serveur que vous envoyez à Facebook, un score event match quality est affiché. Ce score dépend du nombre de données utilisateur envoyées.

Si vous utilisez un sous-domaine personnalisé pour votre serveur de tagging, seules l’IP utilisateur, l’identifiant de navigateur, _fbp et _fbc sont envoyés à Facebook CAPI. Si vous n’envoyez que ces paramètres, la qualité de correspondance sera autour de 4 sur 10.

Pour avoir un score élevé, il est important d’envoyer autant de paramètres que possible. Facebook utilise ces données pour faire correspondre les utilisateurs de votre site à ceux de sa base. Avant cela, vérifiez que l’envoi de ces données respecte votre politique de confidentialité et les règles en vigueur. Techniquement, envoyer plus de paramètres est positif. L’audience et les données de conversion seront plus précises, les algorithmes de Facebook auront des données plus spécifiques sur vos utilisateurs, les campagnes performeront mieux.

Comment augmenter le score de qualité de correspondance ? La réponse est simple : envoyer plus de données utilisateur. La mise en œuvre reste complexe. Voici comment je procède : je vérifie d’abord si un data layer est implémenté sur votre site et s’il contient toutes les données utilisateur. Par exemple, si l’utilisateur peut se connecter à votre site, vérifiez que les détails de l’utilisateur sont envoyés dans le data layer lorsqu’il est connecté.

Si le data layer n’est pas implémenté, confiez sa mise en place à vos développeurs.

Ensuite, assurez-vous de passer tous les paramètres utilisateur du conteneur web au conteneur serveur.

Une autre aide pour augmenter la qualité de correspondance est une nouvelle fonction de Data Tag. Nous avons ajouté la possibilité de stocker des données utilisateur. Par exemple, si un utilisateur a soumis un formulaire de contact sur le site, Data Tag peut stocker ses données dans le local storage, puis les réutiliser sur d’autres pages.

6. Même Event ID reçu pour plusieurs instances d’événements

Si vous suivez des événements Facebook depuis le navigateur et depuis le serveur, Facebook exige d’envoyer un identifiant d’événement unique pour chaque événement. Pour les événements correspondants, le nom d’événement du pixel Facebook doit être identique au nom d’événement du serveur. Idem pour l’Event ID : les mêmes événements depuis le pixel Facebook doivent correspondre aux événements serveur. La déduplication se déclenche alors.

Cette erreur se produit quand vous envoyez le même Event ID pour plusieurs événements. Par exemple, un utilisateur arrive sur une page produit. Deux événements doivent se déclencher, PageView et ViewContent. Vous devez envoyer un Event ID unique pour chaque événement. Vos événements et identifiants doivent ressembler à ceci:

FB browser: PageView, eventID: ‘69’ FB server: PageView, eventID: '69'
FB browser: ViewContent, eventID: '79' FB server: ViewContent, eventID: '79'

Même si ces événements se déclenchent sur la même page et peuvent utiliser le même déclencheur dans les conteneurs web et serveur GTM, vous devez envoyer un Event ID unique pour chacun.

Same Event ID Received for Many Event Instances se produit si vous avez ce cas:

FB browser: PageView, eventID: ‘69’ FB server: PageView, eventID: '69'
FB browser: ViewContent, eventID: '69' FB server: ViewContent, eventID: '69'

Dans cet exemple, nous envoyons eventID 69 pour PageView et pour ViewContent. Facebook s’attend à voir un Event ID unique pour ces deux événements.

Solution: ajoutez un Facebook test ID, ouvrez le mode aperçu des conteneurs web et serveur, testez la configuration. Après avoir trouvé quand l’erreur se produit, nous pouvons corriger.

Nous avons créé une variable personnalisée qui génère un Event ID unique. Je recommande d’utiliser cette variable pour configurer la déduplication des événements Facebook. Vous pouvez ajouter le nom d’événement à cette variable afin de garantir l’unicité. Même si vos événements utilisent le même déclencheur, l’Event ID sera unique, car il contient event_name_eventID. Vous pouvez en savoir plus sur la déduplication Facebook dans la section ci-dessus.

Mappage du nom d’événement

Par défaut, le tag essaie de mapper les événements standards GA aux événements standards Facebook. S’il ne peut pas les faire correspondre, le nom brut de l’événement reçu du client GA est utilisé. Par exemple, si vous envoyez un événement nommé gtag('event','UserLikedProduct'), vous verrez l’événement UserLikedProduct dans Facebook Events Manager.

Ci-dessous se trouve le schéma de mappage des événements GA vers Facebook utilisé par défaut par ce tag:

page_viewPageView
add_payment_infoAddPaymentInfo
add_to_cartAddToCart
add_to_wishlistAddToWishlist
sign_upCompleteRegistration
begin_checkoutInitiateCheckout
generate_leadLead
purchasePurchase
searchSearch
view_itemViewContent
contactContact
customize_productCustomizeProduct
donateDonate
find_locationFindLocation
scheduleSchedule
start_trialStartTrial
submit_applicationSubmitApplication
subscribeSubscribe

Google Analytics vers événements Facebook

Pour faciliter la migration de votre tag Facebook GTM web vers le conteneur serveur, nous avons essayé de mapper toutes les données que le client GA reçoit vers l’événement Facebook sans réglage de votre part. Le tag prend aussi en charge le mappage des événements Enhanced Ecommerce GA, et bien sûr, il peut remplacer tous les paramètres d’événement envoyés à Facebook.

Par exemple, si le tag détecte que le type d’événement est Purchase, nous déterminerons la liste des produits, leur devise et la valeur.

Dans les sections ci-dessous, nous décrivons comment les données sont mappées dans chaque groupe de paramètres.

Configuration du tag Facebook

Mappage par défaut et remplacement Server Event Data

Il n’y a que quelques paramètres dans la catégorie Server Event Data. Consultez cette documentation pour plus de détails sur les paramètres existants.

Paramètres définis par défaut:

event_nameEvent Name
event_source_urlPage Location
action_sourceWhere your conversions occurred. (For example: website, email, app)
event_timeCurrent Time

Mappage par défaut et remplacement User Data

Avec l’option User Data du tag, vous pouvez remplacer ou ajouter n’importe quelle donnée utilisateur envoyée à Facebook. Consultez la documentation Facebook pour la liste des paramètres User Data que vous pouvez ajouter. Si la documentation indique que le paramètre doit être haché, vous devez le hacher en SHA256, sinon l’envoi ne sera pas accepté par Facebook.

fbcCookie value ‘_fbc’ or ‘fbclid’ url parameter if exist
fbpCookie value ‘_fbp’
external_idexternal_id or user_id or userId
subscription_idsubscription_id or subscriptionId
lead_idlead_id or leadId
lnlastName or LastName or nameLast
fnfirstName or FirstName or nameFirst
ememail
phphone
gegender
ctcity
ststate
zpzip
countrycountryCode

Mappage par défaut et remplacement Custom Data

Vous pouvez aussi remplacer d’autres paramètres ou en ajouter via la section Custom Data dans la configuration du tag. Consultez cette documentation pour la liste des paramètres Custom Data possibles.

Si le paramètre Enhanced Ecommerce items existe, le tag définit content_type sur product. Les paramètres produits GA item_name, item_category sont mappés vers Facebook content_name, content_category.

Le tag essaie aussi de déterminer d’autres paramètres produits, y compris:

valuex-ga-mp1-ev or value
currencycurrency
transaction_idorder_id

Si le type d’événement est Purchase mais que la devise ne peut pas être déterminée, USD est utilisée par défaut. Facebook n’accepte pas les événements Purchase sans paramètre currency.

Suivi côté serveur Facebook : résolution des problèmes réels des utilisateurs de Stape

1. Un utilisateur de la communauté a remarqué qu'après être passé au suivi côté serveur de Facebook, son public de reciblage était beaucoup plus restreint que le trafic GA4 (taux de correspondance d'environ 15 %). Le problème ne venait pas d'un suivi défaillant, mais d'attentes irréalistes : Facebook ne peut pas faire correspondre de manière fiable les utilisateurs en utilisant uniquement l'adresse IP et l'agent utilisateur. La solution consistait à suivre la configuration hybride recommandée par Meta (navigateur + serveur avec déduplication) et à envoyer toutes les données utilisateur disponibles (comme l'adresse e-mail ou le nom, lorsque cela était possible). Cette approche améliore la qualité de la correspondance et la taille de l'audience, tandis que le suivi côté serveur seul limite le potentiel de reciblage.

2. De nombreux utilisateurs de ce fil de discussion sont confrontés à des problèmes liés au suivi côté serveur de Facebook et au mappage FBP/FBC, en particulier lors des paiements effectués via des tiers. L'utilisation du modèle CAPI Facebook de Stape sur un sous-domaine propriétaire, le déclenchement d'événements clés sur le domaine principal, la mise en œuvre d'événements hybrides navigateur+serveur pour la déduplication et, éventuellement, l'utilisation de webhooks permettent de résoudre la plupart des problèmes. Vérifiez toujours les données à l'aide des outils réseau du navigateur plutôt que de vous fier uniquement à Tag Assistant.

Conclusion

Nous espérons que vous avez déplacé avec succès le suivi Facebook vers le serveur. Facebook Conversions API est un bon outil pour mieux comprendre qui est votre client, voir le parcours jusqu’à la conversion et envoyer plus de données sur vos utilisateurs aux algorithmes d’apprentissage de Facebook.

author

Ira Holubovska

Author

Ira possède plus de 10 ans d'expérience en marketing digital, avec 5 ans consacrés au suivi côté serveur. Elle sait comment et quand l'utiliser dans divers scénarios marketing.

Commentaires

Essayez Stape pour tout ce qui concerne le côté serveur

Qu'est-ce qui se passe ?

Où allons-nous ?

Attention !
Ceci est une zone de stand-up pour chiens.