Aller au contenu principal

Test des Événements Facebook Pixel et CAPI avec Facebook Events Manager

Introduction​

Tester vos événements Facebook Pixel et API de Conversions (CAPI) en utilisant l'outil d'Événements de Test dans Events Manager est un moyen efficace de valider que votre boutique PrestaShop envoie correctement les événements du navigateur et côté serveur (CAPI).

Cette méthode est particulièrement utile pour tester des événements complexes qui n'apparaissent pas toujours dans Pixel Helper, tels que :

  • Initiate Checkout
  • Add Payment Info
  • Retards de Suivi des Événements Purchase

Ce guide vous guidera à travers le processus étape par étape pour activer le mode test et analyser les événements dans l'outil d'Événements de Test de Meta.

Étape 1 : Obtenir le Code d'Événement de Test depuis Events Manager​

Pour commencer les tests, vous devez d'abord récupérer le Code d'Événement de Test depuis Events Manager de Facebook.

📌 Comment Obtenir le Code de Test​

  1. Allez sur Meta Business Suite : Connectez-vous à Meta Business Manager.
  2. Ouvrez Events Manager : Naviguez vers Events Manager.
  3. Sélectionnez Votre Pixel : Choisissez l'ID Pixel utilisé dans votre boutique PrestaShop.
  4. Allez dans l'Onglet "Événements de Test" : Cliquez sur la section Événements de Test.
  5. Copiez le Code d'Événement de Test :
    • Vous verrez un code de test unique, généralement formaté comme TESTXXXXXXXXXX (où XXXXXXXXXX est un numéro aléatoire).
    • Cliquez sur Copier.

📌 Note : Ce code est temporaire et ne fonctionne que pendant que l'outil d'Événements de Test est ouvert.

Étape 2 : Activer le Mode Test dans le Module Pixel Plus​

Maintenant que vous avez le Code d'Événement de Test, vous devez le saisir dans le module Pixel Plus pour PrestaShop.

📌 Comment Activer le Mode Test dans le Module​

  1. Allez dans le Back Office PrestaShop.
  2. Naviguez vers Modules > Pixel Plus > Paramètres de l'API de Conversions (CAPI).
  3. Trouvez le Champ Événements de Test :
    • Faites défiler pour trouver un paramètre étiqueté "Code d'Événements de Test" (ou similaire).
    • Collez le Code d'Événement de Test que vous avez copié depuis Events Manager.
  4. Restreignez les Tests à Votre IP :
    • Localisez la zone "Limiter la Journalisation à des IPs Spécifiques".
    • Cliquez sur "Ajouter Mon IP" pour ajouter automatiquement votre adresse IP actuelle.
    • Cela garantit que seules vos actions sont enregistrées, évitant les données inutiles.
  5. Activez le Mode Test dans le Module :
    • En dessous de la zone IP, trouvez l'option qui permet d'activer le mode test.
    • Réglez-la sur "Oui" pour activer la journalisation des événements de test.
  6. Cliquez sur Enregistrer pour appliquer les modifications.

🔍 Pourquoi Restreindre les Tests à Votre IP ?

  • Empêche les journaux d'événements d'être remplis par les actions de vrais clients.
  • Garantit que seules vos actions sont enregistrées pour analyse.

Étape 3 : Déclencher des Événements de Test depuis Votre Boutique​

Maintenant que le Mode Test est activé, il est temps de simuler des actions de clients sur votre boutique PrestaShop.

📌 Comment Ouvrir Votre Boutique en Mode Test​

  1. Retournez à Events Manager dans Meta Business Suite.
  2. Recherchez l'URL des Événements de Test :
    • Meta suggérera le domaine de votre boutique (par ex., https://votreboutique.com).
    • Cliquez sur l'URL de votre boutique.
  3. Un Nouvel Onglet S'ouvrira : Cet onglet est maintenant lié à l'outil d'Événements de Test.
  4. Effectuez des Actions sur Votre Boutique :
    • Voir un produit.
    • Ajouter un produit au panier.
    • Commencer le processus de paiement.
    • Simuler un achat.

Étape 4 : Analyser les Événements dans Events Manager​

Une fois que vous avez effectué des actions sur votre boutique PrestaShop, retournez à Events Manager pour analyser les données entrantes.

📌 Comment les Événements Apparaissent dans l'Outil de Test​

  • Événements du Navigateur (basés sur Pixel) → Apparaissent presque instantanément.
  • Événements du Serveur (basés sur CAPI) → Prennent quelques secondes à une minute pour apparaître.

Identifier les Événements Dédupliqués​

Facebook regroupe automatiquement les événements du navigateur et du serveur correspondants. Vous pouvez facilement identifier :

  • Événement du Navigateur (envoyé via Pixel).
  • Événement du Serveur (envoyé via CAPI).
  • ID de l'Événement (utilisé pour la déduplication).

Vérifier les Données Supplémentaires​

Cliquez sur un événement pour développer les détails. Vous verrez :

  • ID de l'Événement → Garantit que les versions navigateur et serveur sont correctement liées.
  • Données Utilisateur → Détails hachés envoyés pour un meilleur suivi.
  • Paramètres Personnalisés → Exemple : ID produit, prix, catégorie.

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

Après un certain temps, vous devriez voir l'événement de deux sources, le pixel et le serveur. Si le second n'apparaît pas même après avoir attendu quelques minutes, un paramètre de performance dans le module pourrait en être le "coupable".

Le module utilise un nouveau système pour envoyer les événements de manière asynchrone. Ce système fonctionne bien sur 95% des serveurs, mais sur certains les événements ne passent pas.

Si vous ne voyez pas l'événement dans Events Manager, il y a une forte probabilité que ce paramètre vous affecte. Pour désactiver son utilisation, vous n'avez besoin que d'une minute.

Désactiver Multi-cURL​

  • Allez à la page de configuration du module.
  • Ouvrez la section CAPI et faites défiler jusqu'à la fin.
  • Activez l'option pour désactiver l'utilisation de multi-cURL.
  • Enregistrez les modifications et réessayez d'envoyer les événements.

Étape 5 : Confirmer que les Événements Sont Envoyés par Pixel Plus​

Lors de la vérification de tout événement (navigateur ou serveur), Pixel Plus inclut toujours un paramètre spécifique :

"event_trigger": "Pixel Plus"

✅ Si vous voyez le champ event_trigger: "Pixel Plus" dans les détails de l'événement, cela confirme que l'événement a été déclenché par le module Pixel Plus.

Si ce champ est absent, il est possible que :

  • Un autre module
  • Du code JavaScript manuel (par ex., appels fbq())
  • Des gestionnaires de balises comme GTM

envoient des événements indépendamment.

Cette vérification est essentielle pour éviter le suivi en double et garantir des données propres.

Cela aide également à identifier des événements potentiellement dupliqués ou des événements envoyés depuis des sources externes qui peuvent causer des problèmes avec le suivi. Consultez notre guide Détecter les Sources Externes Envoyant des Événements pour plus d'informations.

Étape 6 : Certains Événements Ne Sont Visibles que dans l'Outil d'Événements de Test​

Certains événements — comme "Initiate Checkout" et "Add Payment Info" — peuvent ne pas toujours apparaître dans Meta Pixel Helper.

Cela se produit parce que :

  • Ils sont déclenchés côté serveur (via CAPI).
  • Certains navigateurs ou paramètres de confidentialité bloquent le suivi côté client.

✅ Cependant, ces événements apparaîtront correctement dans l'outil d'Événements de Test dans Facebook Events Manager.

🔍 Important : Si vous ne voyez pas un événement dans Pixel Helper, vérifiez toujours l'outil d'Événements de Test avant de supposer qu'il y a un problème.

Étape 7 : Que Faire Si Aucun Événement Serveur N'apparaît​

Si, après avoir effectué des actions sur votre boutique, vous ne voyez aucun événement côté serveur apparaître dans l'outil d'Événements de Test, suivez ces étapes pour dépanner :

📋 Liste de Vérification à Examiner​

  1. Vérifiez votre configuration Pixel Plus :

    • Assurez-vous que le Code de Test est correctement collé dans le champ "Code d'Événements de Test".
    • Confirmez que "Activer les Événements de Code de Test" est réglé sur Oui.

  2. Assurez-vous d'avoir enregistré la configuration :

    • Après avoir collé le code et activé l'option, cliquez toujours sur Enregistrer pour appliquer les modifications.

  3. Vérifiez les Paramètres de Restriction IP :

    • Si vous avez ajouté votre IP sous "Limiter les Tests par IP", confirmez qu'elle est correctement détectée.
    • Cette restriction aide à éviter de mélanger vos tests avec le trafic client.

  4. Considérez les Différences d'IP entre Serveur et Utilisateur :

    • Dans certaines configurations (par ex., proxies inverses, équilibreurs de charge, Cloudflare), l'adresse IP que Facebook voit peut ne pas correspondre à votre vraie IP.
    • Si vous soupçonnez que c'est le cas :
      • Désactivez temporairement la restriction IP.
      • Effectuez votre test rapidement.
      • Soyez conscient que sans restriction, des événements externes supplémentaires peuvent apparaître dans le journal.

🚨 Important : Ne désactivez la restriction IP que temporairement pendant les tests. Réactivez-la après pour maintenir des données de test propres.

📈 Pourquoi les Événements Serveur Pourraient Manquer​

Si les événements serveur manquent, cela signifie généralement :

  • Le Mode Test n'a pas été complètement activé.
  • Le Code de Test manquait ou n'a pas été correctement enregistré.
  • La restriction IP empêchait l'événement d'être journalisé.

Après avoir corrigé les paramètres, répétez vos actions sur la boutique (par ex., voir un produit, ajouter au panier, commencer le paiement) et vérifiez à nouveau dans l'outil d'Événements de Test.

Conclusion​

En suivant ce guide, vous pouvez tester et déboguer les événements Facebook Pixel et CAPI dans PrestaShop en utilisant l'Outil d'Événements de Test d'Events Manager.

🎯 Ce Que Vous Avez Accompli :​

✔ Récupéré le Code d'Événement de Test de Facebook ✔ Activé le Mode Test dans le module Pixel Plus ✔ Ouvert votre boutique PrestaShop en mode test ✔ Vérifié les événements dans l'outil d'Événements de Test de Facebook ✔ Confirmé que les événements sont correctement attribués à Pixel Plus ✔ Comparé les événements du navigateur et du serveur pour la déduplication ✔ Identifié les événements difficiles à suivre au-delà de la détection de Pixel Helper

🚀 Conseil Final : N'oubliez pas de désactiver l'option de code de test après avoir terminé vos tests pour éviter les faux positifs ou les alertes trompeuses de Facebook.

Qu'est-ce que l'outil d'Événements de Test de Facebook Events Manager et à quoi sert-il ?

L'outil d'Événements de Test dans Facebook Events Manager vous permet de voir en temps réel les événements envoyés par votre Pixel navigateur et par l'API de Conversions côté serveur. Il est particulièrement utile pour vérifier des événements complexes qui n'apparaissent pas toujours dans Pixel Helper, comme les événements CAPI ou les événements d'achat.

Comment activer le mode test dans Pixel Plus pour l'utiliser avec Events Manager ?

Dans Facebook Events Manager, copiez le code de test depuis la section Événements de Test. Allez ensuite dans le Back Office de PrestaShop, accédez à Pixel Plus, cherchez la section CAPI et collez le code dans le champ Code de Test. Activez l'option d'événements de code de test et, optionnellement, cliquez sur Ajouter Mon IP pour restreindre le mode test à votre session.

Pourquoi est-il important de restreindre le code de test à mon IP ?

Si vous ne restreignez pas le code de test à votre IP, tous les visiteurs de votre boutique enverront des événements en mode test sur Facebook, ce qui peut contaminer les données de test et générer des alertes ou des problèmes sur votre pixel. Ajoutez toujours votre IP pendant les tests et désactivez le code de test quand vous avez terminé.

Quelle est la différence entre les événements navigateur et les événements serveur dans Events Manager ?

Les événements navigateur sont envoyés directement par le code JavaScript du Pixel depuis le navigateur de l'utilisateur. Les événements serveur sont envoyés par l'API de Conversions depuis le serveur PrestaShop. Les deux devraient apparaître dans Events Manager et le système de déduplication de Facebook les combine pour éviter le double comptage.

Que faire si les événements serveur n'apparaissent pas dans l'outil d'Événements de Test ?

Si les événements serveur manquent, vérifiez que le mode test est complètement activé et que le code de test a été correctement enregistré dans Pixel Plus. Vérifiez aussi que la restriction IP ne bloque pas l'enregistrement des événements. Répétez les actions sur la boutique après avoir corrigé la configuration.

📘 Ressources Connexes​