Aller au contenu principal

Test des Événements Facebook Pixel et CAPI dans PrestaShop

Introduction​

Tester vos événements Facebook Pixel et API de Conversions (CAPI) est crucial pour assurer un suivi approprié des événements et la déduplication dans votre boutique PrestaShop. Ce guide vous présentera deux méthodes :

  1. Utiliser l'Extension Pixel Helper de Google Chrome pour vérifier les événements du navigateur.
  2. Utiliser la Fonction de Journalisation de PrestaShop dans la section CAPI du module Pixel Plus pour enregistrer les événements côté serveur.

En suivant ce guide, vous pouvez confirmer que :

✅ Les événements se déclenchent correctement dans le navigateur. ✅ Les événements côté serveur sont enregistrés et traités. ✅ La déduplication fonctionne comme prévu.

Étape 1 : Installer l'Extension Facebook Pixel Helper​

Pour tester les événements du navigateur, vous devez installer Meta Pixel Helper, une extension Google Chrome.

Instructions d'Installation :​

  1. Ouvrez Google Chrome.
  2. Visitez l'extension Meta Pixel Helper.
  3. Cliquez sur "Ajouter à Chrome", puis sur "Ajouter l'extension".
  4. Une fois installée, vous verrez l'icône Pixel Helper dans la barre d'outils de Chrome.

💡 Astuce : Si vous ne voyez pas l'icône Pixel Helper, cliquez sur le menu des extensions (icône de puzzle) et épinglez-la.

Étape 2 : Activer la Journalisation des Événements CAPI dans PrestaShop​

Pour vérifier les événements côté serveur (CAPI), utilisez la fonction de journalisation dans le module Pixel Plus.

Comment Activer la Journalisation CAPI :​

  1. Allez dans le Back Office de PrestaShop.
  2. Naviguez vers Modules > Pixel Plus > Paramètres de l'API de Conversions.
  3. Trouvez l'option "Activer la Journalisation des Événements."
  4. Réglez-la sur "Oui".
  5. (Recommandé) Restreindre la Journalisation à Votre IP :
    • Localisez la zone "Limiter la Journalisation à des IPs Spécifiques".
    • Cliquez sur "Ajouter Mon IP" pour ajouter automatiquement votre adresse IP.
    • Cela garantit que les journaux ne sont enregistrés que pour vos tests, évitant la collecte de données inutiles.
  6. Enregistrez la configuration.

Fonctionnalités de Journalisation Supplémentaires :​

  • Voir les Événements Journalisés dans PrestaShop : Une fois activés, les événements seront stockés dans la section journaux de PrestaShop, vous aidant à analyser ce qui est envoyé à Facebook.
  • Champs Clés à Vérifier :
    • events_received → Indique combien d'événements Facebook a reçus avec succès.
    • fbtrace → Un jeton de suivi unique de Facebook. Cela confirme que Facebook a traité l'événement.

🛑 Si ces champs sont absents des journaux, Facebook ne reçoit pas vos événements ! Vérifiez vos paramètres CAPI.

Étape 3 : Commencer à Générer des Événements​

Maintenant que l'extension Pixel Helper est installée et la journalisation CAPI est activée, suivez ces étapes pour tester vos événements Pixel basés sur le navigateur.

  1. Ouvrez votre boutique PrestaShop dans Chrome.
  2. Cliquez sur l'icône Pixel Helper dans la barre d'outils.
  3. Le Pixel Helper affichera tous les événements Facebook Pixel déclenchés sur la page.
  4. Cliquez sur chaque événement pour vérifier :
    • Nom de l'Événement (par ex., PageView, AddToCart, Purchase).
    • ID du Pixel (Devrait correspondre à celui configuré dans le module Pixel Plus).
    • Avertissements ou erreurs (le cas échéant).

📌 Développer les Détails de l'Événement pour Plus d'Informations​

Cliquez sur le triangle noir (▸) à côté d'un événement pour développer ses détails. Cela révèle :

  • ID de l'Événement (utilisé pour la déduplication avec les événements CAPI).
  • Paramètres de données utilisateur (par ex., email, numéro de téléphone, hachés pour la confidentialité).
  • Paramètres personnalisés (par ex., ID du produit, prix).
  • Diagnostics (avertissements concernant les paramètres manquants ou mal configurés).

⚠️ Problème Courant : Si Pixel Helper ne montre aucun événement, assurez-vous que :

  • L'ID du Facebook Pixel est correctement configuré.
  • Aucun bloqueur de publicités ne bloque le script.
  • Le Pixel se déclenche sur la page.
  • Le module n'est pas bloqué par un module/système de gestion du consentement

🛑 Conseil de Dépannage : Si les événements disparaissent après peu de temps, essayez de déclencher un événement, basculer vers un autre onglet, puis revérifier le journal de Pixel Helper.

Étape 4 : Vérifier si Facebook a Reçu l'Événement (CAPI)​

Facebook fournit des paramètres de confirmation qui indiquent si l'événement a été reçu.

📌 Champs Importants à Vérifier dans les Journaux PrestaShop​

  • events_received → Indique combien d'événements Facebook a reçus.
  • fbtrace → Un jeton de suivi unique de Facebook qui confirme le traitement de l'événement.

⚠️ Si events_received est absent :

  • Multi-cURL pourrait causer des problèmes.
  • Désactivez multi-cURL dans les options CAPI (dernière option dans les paramètres).
  • Enregistrez les modifications et réessayez d'envoyer les événements.

Étape 5 : Comparer les Événements du Navigateur et du Serveur pour la Déduplication​

Maintenant que Pixel Helper (navigateur) et les journaux CAPI (serveur) sont actifs, comparez les résultats.

✅ Ce qu'il Faut Rechercher :​

  • Le même événement (par ex., Purchase) devrait apparaître dans les deux :
    • Pixel Helper (navigateur)
    • Journaux CAPI (serveur)

Cela conduira à la déduplication des événements, ce qui signifie que seul l'événement le plus significatif sera conservé par Facebook. Pour que cela se produise, il est nécessaire que :

  • L'ID de l'Événement dans Pixel Helper et les journaux CAPI correspondent.

Comment Vérifier la Déduplication :​

  1. Ouvrez Pixel Helper et développez les détails de l'événement.
  2. Recherchez l'ID de l'Événement.
  3. Ouvrez les journaux CAPI de PrestaShop et trouvez le même événement.
  4. Comparez l'ID de l'Événement dans les deux endroits.
  5. S'ils correspondent, Facebook dédupliquera l'événement et optimisera en fonction de la source la plus fiable.

⚠️ Pixel Helper Peut Masquer les Événements au Fil du Temps ! Si l'événement disparaît :

  • Déclenchez à nouveau l'événement (par ex., ajoutez un produit au panier).
  • Basculez vers un autre onglet.
  • Revenez à Pixel Helper pour vérifier si les journaux d'événements sont toujours disponibles.

Conclusion​

En suivant ce guide, vous pouvez tester et déboguer vos événements Facebook Pixel et API de Conversions dans PrestaShop.

Ce Que Vous Avez Accompli :​

✔ Vérifié que les événements du navigateur se déclenchent en utilisant Pixel Helper. ✔ Activé la journalisation des événements CAPI et l'avez restreinte à votre IP. ✔ Comparé les événements du navigateur et du serveur pour confirmer la déduplication.

🚀 Prochaine Étape : Si vous rencontrez toujours des problèmes, vérifiez les Outils de Débogage de Facebook ou examinez les configurations CAPI et Pixel dans le module Pixel Plus.

Pour plus de détails, visitez le Guide Officiel de Débogage des Événements Facebook.

Qu'est-ce que Meta Pixel Helper et comment l'utiliser pour vérifier les événements Facebook ?

Meta Pixel Helper est une extension Chrome qui affiche en temps réel les événements envoyés par le Facebook Pixel depuis le navigateur. Installez-la depuis le Chrome Web Store, visitez votre boutique et vous verrez les événements qui se déclenchent avec leurs paramètres, comme le type d'événement, l'ID du produit et la valeur.

Comment activer la journalisation des événements CAPI dans Pixel Plus ?

Allez dans le Back Office de PrestaShop, accédez à Pixel Plus et cherchez la section CAPI. Activez l'option de journalisation des événements et, pour plus de sécurité, cliquez sur Ajouter Mon IP pour restreindre les journaux à votre session actuelle. Cela vous permet de voir tous les événements côté serveur envoyés par le module.

Comment vérifier la déduplication entre les événements navigateur et serveur ?

Ouvrez Pixel Helper et développez les détails d'un événement pour voir son ID d'Événement. Ouvrez ensuite les journaux CAPI de Pixel Plus et recherchez le même événement. Si les deux ont le même ID d'Événement, Facebook les dédupliquera correctement et ne comptera pas le même événement deux fois.

Pourquoi les événements disparaissent-ils dans Pixel Helper après un certain temps ?

Pixel Helper peut masquer les événements plus anciens à mesure que de nouveaux s'accumulent. Si un événement disparaît, déclenchez-le à nouveau (par exemple, ajoutez un produit au panier), passez à un autre onglet et revenez à Pixel Helper pour voir si le journal est encore disponible.

Quelle est la différence entre tester avec Pixel Helper et avec Events Manager ?

Pixel Helper affiche uniquement les événements du navigateur en temps réel et est utile pour des vérifications rapides. Events Manager avec Test Events affiche à la fois les événements navigateur et serveur CAPI, et est plus complet pour vérifier la déduplication et les événements complexes qui n'apparaissent pas toujours dans Pixel Helper.