Facebook Pixel : installation et aide

Suivez les étapes du Démarrage rapide.

Ouvrez "Configure" dans "Module Manager". Le module fournit un formulaire de paramètres, un panneau de connexion Meta, un guide de configuration et des contrôles de propriété du suivi. Utilisez un compte Back Office autorisé à configurer le module ; l'action de connexion vérifie les droits de modification et le jeton administrateur.

Avec la protection du consentement activée et un module MPR pris en charge actif, l'en-tête prépare un contrôle de consentement navigateur. Il démarre le Pixel après autorisation et écoute mprcr:consent et mprcookie:consent. La vérification serveur lit la décision marketing MPR et utilise la valeur par défaut configurée dans le module de consentement lorsque son cookie est absent. Si aucun des modules MPR pris en charge n'est actif, la protection de ce module autorise le suivi. Configurez séparément tout autre outil de consentement utilisé.

Utilisez les contrôles de propriété si une autre intégration MPR gère aussi la même destination Meta. Ce module vérifie la capacité meta_pixel avant l'envoi. Retirez les extraits Pixel en double installés indépendamment dans le thème ou d'autres modules.

Événements navigateur

Tous les événements standard sont activés par défaut. Désactivez ceux dont vous n'avez pas besoin.

PageView est envoyé au démarrage du Pixel navigateur. Il n'a pas de paramètre distinct. Le comportement produit, panier et liste de souhaits dépend des données et événements exposés par le thème. Testez explicitement les contrôles personnalisés.

Le module n'envoie que Purchase via CAPI. Les autres événements standard et règles personnalisées utilisent le Pixel navigateur.

actionValidateOrder et displayOrderConfirmation peuvent mettre la même commande en file. L'identité de file évite les admissions en double pour cet événement ; les achats navigateur et serveur utilisent le même ID stable construit depuis l'ID commande. Les données d'achat incluent valeur TTC, devise, ID produits, contenu des lignes et quantité. Les données serveur construisent aussi les données de rapprochement client et identifiants de cookies Facebook disponibles.

Le module tente un petit lot de trois événements pendant ces hooks. Il enregistre aussi la tâche cron partagée :

task: send_facebook_conversions
callable: mprfacebookpixel::cronProcessFacebookConversions
schedule: every:300
context: any
timeout: 30

Assurez-vous que l'exécuteur cron MPR partagé exécute la tâche enregistrée. Le lot normal du worker est de 20 ; ce module n'a pas de champ de taille de lot. Le worker peut réessayer les événements en attente. Le nettoyage conserve les lignes envoyées 30 jours et les autres anciennes lignes 90 jours. Un changement de liaison de propriété peut faire abandonner les lignes anciennes ou remplacées au lieu de les envoyer.

L'ID identique des événements navigateur/serveur permet la déduplication chez le fournisseur. Meta décide de l'attribution des conversions ; vérifiez l'envoi et les résultats d'attribution dans Meta.

"Track custom events" est désactivé par défaut. "Custom event rules" est initialement vide. Ajoutez les règles avant d'activer l'option. Utilisez un nom distinct commençant par une lettre, contenant lettres, chiffres ou traits de soulignement, avec au maximum 50 caractères. Les noms standard Meta sont réservés. Le module limite le traitement à 50 règles et 50 noms d'événements personnalisés distincts.

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-cover img","params":{"area":"product_gallery"},"once":false},
  {"event":"SizeGuideView","trigger":"url","contains":["/size-guide"],"params":{"area":"product_help"}},
  {"event":"AccountAreaView","trigger":"controller","controllers":["my-account"]},
  {"event":"ModuleCheckoutView","trigger":"controller","modules":["onepagecheckout"]},
  {"event":"ConfiguratorCompleted","trigger":"event","dom_event":"product-configurator:complete","params":{"source":"configurator"}}
]

Utilisez selector, contains, controllers/modules ou dom_event pour le déclencheur correspondant. enabled et once valent true par défaut. params fournit des paramètres d'événement assainis. Le module appelle fbq('trackCustom', ...) pour ces règles.

Déclenchez votre événement DOM personnalisé depuis le JavaScript du thème :

document.dispatchEvent(new CustomEvent('product-configurator:complete', {
  detail: {source: 'configurator', product_type: 'custom_size'}
}));

Gardez les sélecteurs et noms de contrôleur/module cohérents avec le thème et le processus de commande installés.

Ouvrez la boutique dans un navigateur client et inspectez la requête Pixel après la décision de consentement applicable. Vérifiez selon vos besoins PageView, un ViewContent produit, ajout au panier, début de commande, recherche, liste de souhaits et inscription. Utilisez une commande test pour Purchase.

Pour CAPI, consultez le panneau de connexion et Meta Test Events avec le code test enregistré. Confirmez que l'achat serveur utilise l'ID d'événement de l'achat navigateur. Vérifiez l'exécution du worker si une nouvelle tentative est en attente. Effacez le code test et enregistrez après validation. La vérification de connexion exige une action Back Office autorisée ; n'exposez pas les jetons d'accès dans des captures ou du code frontend personnalisé.

Si rien ne charge, vérifiez l'activation, le "Pixel ID" numérique, la propriété de capacité, le contexte employé, la décision de consentement et les scripts bloqués. Recherchez les chargeurs en double.

Si un événement manque, vérifiez son option et les données produit/panier requises. L'inscription est consommée sur my-account ; une autre redirection après inscription peut la retarder. Une liste de souhaits personnalisée nécessite un ID produit exposé ou une règle personnalisée.

Si CAPI est inactif, vérifiez son option, le jeton, l'activation générale, Suivre les achats et la propriété. Consultez erreurs serveur/cron et réponse du fournisseur. Le blocage du consentement navigateur et l'attribution Meta peuvent faire diverger les rapports des totaux PrestaShop.

Réglez "Enable Facebook Pixel" sur Non et enregistrez pour suspendre les envois navigateur et serveur du module. Désinstallez via "Module Manager" pour retirer son menu, son enregistrement cron et sa configuration. La table de file partagée est conservée si un autre module utilise le paquet de conversion ; sinon l'assistant de désinstallation la supprime. Gérez séparément Pixel, jeu de données et historique des rapports dans Meta.

Utilisez les noms de paramètres ci-dessus lorsqu'une capture diffère de votre version installée.