Erreurs de l'API conversion de Facebook et comment les corriger

La configuration de l'API conversion de Facebook peut être déroutante. Mais après avoir fait le travail énorme de déplacer le suivi FB vers le serveur, vous espérez que tout fonctionne bien, vous pouvez vous connecter à votre gestionnaire d'événements le lendemain et voir des avertissements rouges et jaunes pour les événements envoyés depuis le serveur.

J'ai rencontré ce problème à plusieurs reprises lors de la configuration de FB CAPI pour les clients. Donc, j'ai décidé de créer un article avec quelques conseils utiles. Dans cet article de blog, je décrirai les erreurs et les avertissements de l'API conversion de Facebook les plus populaires. En plus, je partagerai quelques conseils comment les réparer.

Comment vérifier s'il y a des erreurs du pixel Facebook ou d'API conversionCopier le lien vers cette section

L'outil d'événements de test Facebook est un nouvel outil puissant qui vous permet de déboguer et de résoudre les problèmes avec vos pixels FB ou vos événements de serveur. S'il y a des erreurs, elles seront affichées dans l'onglet Diagnostics de la barre d'outils afin que vous puissiez les examiner de plus près.

Les erreurs marquées en rouge nécessitent généralement la réaction rapide et doivent être corrigées immédiatement. Les erreurs jaunes sont des avertissements non critiques auxquels vous devriez prêter attention et examiner éventuellement.

Facebook permet de marquer les problèmes comme résolus ou de les ignorer. Si vous marquez une erreur comme résolue et que cette erreur se répète, Facebook l'affichera de nouveau dans 3 jours. En comparaison, les problèmes ignorés vont dans la section Ignored et y restent.

Lorsque vous résolvez des problèmes avec votre suivi FB, je vous propose de les marquer comme résolus. De cette façon, vous informerez Facebook que les problèmes ont été résolus et vous recevrez des nouvelles de la plate-forme si ces problèmes se répètent.

Quelles sont les erreurs de pixel Facebook et d'API conversion les plus courantes, et comment les corriger?Copier le lien vers cette section

1. Nouveaux domaines qui envoyent des donnéesCopier le lien vers cette section

Vous pouvez voir tous les domaines qui envoient des données à votre pixel Facebook. Si FB remarque du trafic provenant d'un nouveau sous-domaine, la plateforme vous enverra cet avertissement. Vous pouvez mettre les domaines sur la liste blanche ou sur la liste noire. A l'aide de cette fonctionnalité, vous pouvez bloquer le trafic de vos sites de test ou URL techniques.

Très probablement, vous verrez également le trafic de gtm-msr.appspot.com. Cela peut arriver lorsque vous exécutez le conteneur de débogage/publication ou que les utilisateurs accèdent à votre site avec des js désactivés (certains bots).

Pour créer les listes de domaines, ouvrez l'outil d'événements en Business Manager -> Cliquez sur Paramètres (Settings) -> Faites défiler jusqu'à Traffic Permissions (Autorisations de trafic).

2. Événement qui manquent certains paramètres de déduplicationCopier le lien vers cette section

D'après mon expérience c'est la deuxième erreur Facebook CAPI la plus populaire. Cette erreur signifie que vous n'envoyez pas de clés de déduplication pour vos événements de serveur. Facebook a besoin de ces paramètres pour la déduplication des événements : nom de l'événement et ID de l'événement.

Il est probable que vous envoyiez déjà les noms des événements. Supposons que vous voyiez ce problème car l'ID d'événement n'est pas valide. Vérifiez si vous envoyez bien un ID d'événement pour le pixel Facebook et l'API conversion de Facebook. Cet ID d'événement doit être le même pour l'événement du navigateur et du serveur. Dans ce cas, FB verra le même nom d'événement et le même ID d'événement et lancera la déduplication.

 Par exemple, pour les événements PageView, envoyez le même ID d'événement et le même nom d'événement à partir du pixel Facebook et de FB CAPI.

Pour tester l'ID d'événement, ouvrez l'outil de test d'événement Facebook. Si tout est correct, vous devriez voir l’image similaire à la capture d'écran. C'est ainsi que FB montre qu'il a enregistré les événements PageView du navigateur et du serveur. Ces événements avaient le même ID d'événement. Ils ont donc traité les événements du navigateur et dédupliqué les événements du serveur.

Mais il peut y avoir une autre situation où vous voyez des événements du navigateur et du serveur déclenchés de manière aléatoire. Dans ce cas, vérifiez l'ID d'événement FB. Il est très probable, les ID d'événement ne sont pas identiques. En parlant de cela, vous pouvez utiliser notre variable personnalisée pour le conteneur Web afin de configurer l'ID d'événement Facebook.

 Nous avons aussi un article qui décrit comment configurer la déduplication des événements Facebook.

3. Serveur qui envoie des paramètres clé de correspondance invalides pour l'événement PageViewCopier le lien vers cette section

Ici, Facebook veut vous informer que les valeurs que vous envoyez depuis le serveur ne sont pas uniques ou correctement formatées. Par exemple, vous pouvez envoyer l’adresse IP à l'utilisateur qui inclut des symboles et pas seulement des chiffres. Ou peut-être vous avez tout simplement sélectionné la mauvaise variable, comme par exemple le numéro de téléphone dans le champ de l'e-mail.

Pour vérifier ce qui ne va pas, ouvrez le mode aperçu du serveur Google Tag Manager et du conteneur Web (bien sûr, si vous avez utilisé GTM pour configurer l'API conversion de Facebook). Vous devriez voir quels paramètres utilisateur ont été envoyés à Facebook et s'ils ont été correctement formatés. Testez l'événement, cliquez sur la balise en mode débogage et sélectionnez les valeurs.

Cette erreur peut aussi signifier que vous avez oublié d'inclure un paramètre ou qu'il est mal formaté.

Par exemple, j'ai eu un client qui voulait envoyer le pays d'utilisateur, sa ville en fonction de l'adresse IP. Facebook attend à voir les coordonnées réelles des utilisateurs qu'ils saisissent sur le site et non celles que vous avez automatiquement extraités de l'adresse IP. Cette configuration a également envoyé une erreur concernant les paramètres clé invalides.

Ou peut-être avez-vous essayé de tricher et d'envoyer le même nom d'utilisateur pour tous les événements afin d'améliorer la qualité.

4. Violation potentielle des données personnelles envoyées à FacebookCopier le lien vers cette section

Cette erreur est généralement liée aux événements du navigateur et signifie que Facebook a détecté des données utilisateur dans l'URL. Certains CMS et d'autres outils comme Calendly ou PayPal envoient les détails de l'utilisateur dans l'URL après son inscription ou son achat.

Cette erreur est difficile à corriger, et c'est une tâche pour vos développeurs. Ils doivent améliorer les paramètres de requête d'URL et supprimer toutes les informations utilisateur de l'URL.

5. Améliorer la qualité de correspondance des événements.Copier le lien vers cette section

Pour chaque événement de serveur que vous envoyez à FB, il y aura le score de qualité de correspondance d'événement. Ce score dépend du nombre de données utilisateur que vous envoyez à FB.

Si vous utilisez un sous-domaine personnalisé pour votre serveur de balisage, seuleument IP d’utilisateur, ID du navigateur, _fbp et _fbc sont envoyés à FB CAPI. Si vous n'envoyez que ces paramètres utilisateur, la qualité de la correspondance sera d'environ 4 sur 10.

Il est assez important d'envoyer autant de paramètres que possible. FB utilise ces données pour faire correspondre les utilisateurs de votre site à ceux de leur base de données. Essayez d'envoyer tous les paramètres utilisateur dont vous disposez. Il est évident, vous devez d'abord vérifier les règles de politique de confidentialité indiquées sur votre site. Mais techniquement, il est bien d'envoyer plus de paramètres. Cela signifie que l'audience et les données de conversion seront plus précises, les algorithmes Facebook auront des données plus précis sur vos utilisateurs et les campagnes seront plus performantes.

Comment pouvez-vous augmenter le score de qualité de correspondances d'événement ? La réponse est simple: vous devez envoyer plus de données utilisateur. Mais la mise en œuvre reste toujours le processus complexe. Voici comment cela fonctionne: je commence par vérifier si la couche de données est implémentée sur votre site et s'il contient toutes les données utilisateurs. Par exemple, si l'utilisateur peut se connecter à votre site, vous devez vérifier si les détails d'utilisateur sont envoyés à la couche de données lorsque l’utilisateur est connecté.

Si la couche de données n'est pas implémentée, donnez la tâche de configuration à vos développeurs.

Après cela, assurez-vous que vous avez bien transmis tous les paramètres utilisateur du Web au conteneur du serveur.

Une autre chose qui vous aidera à augmenter la qualité de correspondance est une nouvelle fonctionnalité de la Data Tag. Nous avons ajouté la possibilité de stocker les données utilisateurs. Par exemple, si l'utilisateur a soumis le formulaire de contact sur le site, vous pouvez utiliser la Data Tag pour stocker les données utilisateur dans le stockage local, puis les utiliser sur d'autres pages. Vous pouvez en savoir plus sur cette fonctionnalité ici.

6. Même ID d'événement reçu pour de nombreuses instances d'événementCopier le lien vers cette section

Si vous suivez les événements Facebook à la fois depuis le navigateur et le serveur, Facebook vous oblige à envoyer un identifiant d'événement unique pour chaque événement. Pour les événements correspondants, le nom d’événement de pixel Facebook doit être identique au nom des événements du serveur. La même chose pour l'ID d'événement, les mêmes événements du pixel FB doivent correspondre aux événements du serveur FB. C'est à ce moment-là que la déduplication se produit.

Cette erreur se produit lorsque vous envoyez le même ID d'événement pour de nombreux événements. Par exemple, un utilisateur est dirigé sur la page du produit. Cela signifie que deux événements doivent se déclencher sur cette page : PageView et ViewContent. Vous devez envoyer un ID d'événement unique pour chacun des événements. Cela signifie que les événements FB et les ID d'événement doivent ressembler à :

Navigateur FB : PageView, eventID: ‘69’

Serveur FB: PageView, eventID: '69'

Navigateur FB : ViewContent, eventID: '79'

Serveur FB: 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 le conteneur Web et serveur de Google Tag Manager, vous devez envoyer un ID d'événement unique pour les deux.

Le même ID d'événement reçu pour de nombreuses instances d'événement se produira si vous rencontrez la situation suivante :

Navigateur FB : PageView, eventID: ‘69’

Serveur FB: PageView, eventID: '69'

Navigateur FB: ViewContent, eventID: '69'

Serveur FB: ViewContent, eventID: '69'

Dans cet exemple, nous envoyons l'ID d'événement 69 pour les événements PageView et ViewContent. Mais Facebook attend à voir un eventID unique pour ces deux événements.

Solution: ajoutez un identifiant de test Facebook, ouvrez le mode aperçu des conteneurs Web et serveur et testez la configuration. Une fois que vous avez découvert quand cette erreur se produit, nous pouvons faire plus pour résoudre ce problème.

Nous avons créé une variable personnalisée qui génère un ID d'événement unique. Je propose d'utiliser cette variable pour configurer la déduplication des événements FB. Vous pouvez ajouter le nom d'événement à cette variable pour vous assurer que l'ID d'événement est unique, comme vous le voyez dans la capture d'écran ci-dessous. Dans ce cas, même si vos événements utiliseront le même déclencheur, l'événement ID sera unique puisqu'il se compose de event_name_eventID. Vous pouvez en savoir plus sur la déduplication des événements Facebook dans cet article.

ConclusionCopier le lien vers cette section

La configuration de l'API conversion de Facebook peut sembler compliquée et parfois déroutante. Mais cela vaut le temps et l'effort. Après avoir effectué tout ce travail acharné pour déplacer le suivi FB vers le serveur, la qualité du suivi et de l’audience s'amélioreront.

Cependant, vous pourriez rencontrer des problèmes s'il y a des erreurs dans ce nouveau processus d'intégration. En termes simples, vous pouvez voir des avertissements rouges et jaunes dans le gestionnaire d'événements.

La bonne nouvelle est ce que la plupart de ces problèmes ne sont pas aussi compliqués qu'ils le paraissent et ne coûtent pas cher à résoudre. J'espère que cet article vous aidera à gérer des erreurs et des avertissements les plus courants de l'API conversion de Facebook.