CC Meta Documentation sur le pixel Facebook
Documentation complète pour le plug-in cc_facebook_pixel.Table des matières
1. Introduction
2. installation
3. Activation de la licence
4 Configuration de base
5. modes de suivi
6. suivi côté serveur
7 Mise en file d'attente des événements
8 Événements personnalisés
9. l'appareillage avancé
10. débogage
11 Dépannage
12. LA FAQ
1. Introduction
CC Facebook Pixel est un plug-in professionnel pour WordPress qui permet une intégration complète du site avec l'API Facebook Pixel et Conversions. Il permet de suivre l'activité de l'utilisateur à la fois sur le navigateur et sur le serveur, ce qui permet un suivi plus précis et plus fiable des conversions, même lorsque les utilisateurs utilisent des bloqueurs de publicité.Le plug-in permet un contrôle total sur :
- Intégration avec Facebook Pixel via JavaScript et/ou Conversions API
- suivi des événements standard (PageView, ViewContent, etc.)
- création et mise en œuvre d'événements personnalisés
- correspondance avancée des données de l'utilisateur
- la mise en file d'attente des événements pour une performance optimale
- débogage et tests d'intégration
2. installation
Exigences du système- WordPress 5.0 ou supérieur
- PHP 7.0 ou plus récent
- Téléchargez le fichier ZIP du plug-in à partir de la boutique officielle
- Se connecter au panneau d'administration de WordPress
- Aller à : Plug-ins > Ajouter un nouveau plug-in > Envoyer un plug-in
- Sélectionnez le fichier ZIP téléchargé et cliquez sur "Installer maintenant"
- Une fois l'installation terminée, cliquez sur "Activer le plug-in"
3. Activation de la licence
Il est nécessaire d'activer la licence avant d'utiliser le plug-in :- Après l'installation, rendez-vous sur le site Paramètres > Pixel Facebook
- Cliquez sur l'onglet Licence
- Saisir la clé de licence reçue après l'achat
- Cliquez sur "Activer la licence"
- Une fois l'activation réussie, un message de confirmation s'affiche
Avertissement
Sans licence active, le plug-in fonctionnera en mode restreint, sans possibilité de modifier les paramètres et de configurer le suivi.
4 Configuration de base
Pour configurer les paramètres de base du plug-in :- Aller à : Paramètres > Pixel Facebook
- Dans la section "Paramètres principaux", entrez votre ID de pixel Facebook.
- Sélectionner le mode de suivi (Navigateur uniquement, Serveur uniquement, Hybride)
- Activer ou désactiver les événements standard
- Cliquez sur "Enregistrer les modifications"
// Exemple d'ID de pixel Facebook
123456789012345Conseil
L'ID du pixel Facebook se trouve dans le gestionnaire d'événements Facebook, dans la section Paramètres du pixel.
5. modes de suivi
Le plug-in offre trois modes de suivi qui peuvent être sélectionnés en fonction de vos besoins :Navigateur uniquement (JavaScript Pixel)
Dans ce mode, les événements sont uniquement envoyés via le pixel JavaScript dans le navigateur de l'utilisateur. Il s'agit d'une méthode de suivi classique qui peut être bloquée par les adblocks.
Serveur uniquement (API Conversions)
Dans ce mode, les événements sont uniquement envoyés par le serveur via l'API Facebook Conversions. Il s'agit d'une méthode de suivi plus fiable qui n'est pas bloquée par les bloqueurs de publicité, mais qui nécessite une configuration supplémentaire.
Hybride (navigateur + serveur avec déduplication)
Dans ce mode, les événements sont envoyés par le biais du pixel JavaScript et de l'API Conversions, avec un mécanisme de déduplication qui empêche le double comptage des événements. Ce mode offre la plus grande précision de suivi.
Info
Le mode hybride est recommandé pour la plupart des sites car il combine les avantages des deux méthodes de suivi, ce qui permet d'obtenir des données de conversion plus précises.
6. suivi côté serveur
Pour mettre en place un suivi côté serveur (API Conversions) :- Assurez-vous que le mode "Serveur uniquement" ou "Hybride" est sélectionné.
- Dans la section "Suivi de l'API côté serveur", saisissez le jeton d'accès.
- En option, activer le mode test et entrer le code de l'événement test.
Avertissement
Le jeton d'accès est une clé confidentielle qui doit être protégée. Ne le partagez pas avec des tiers et ne le placez pas dans des lieux publics.
- Aller à Gestionnaire d'événements à business.facebook.com
- Sélectionner "Sources de données"
- Aller à "Réglages"
- En section "Configurer l'intégration directe". sélectionner un lien "Générer un jeton d'accès" générer un jeton d'accès à l'API
7 Mise en file d'attente des événements
La fonction de mise en file d'attente des événements permet de différer le traitement des événements côté serveur, ce qui améliore considérablement les performances du site :- Dans la section "Suivi de l'API côté serveur", activez l'option "Mise en file d'attente des événements".
- L'onglet "File d'attente d'événements" permet de configurer et de contrôler la file d'attente.
Pour des performances optimales, nous vous recommandons de mettre en place une tâche cron sur le serveur :
- Sous "Event Queue", copiez l'URL vers cron
- Ajoutez une tâche cron sur le serveur qui appellera cette URL toutes les 5 minutes.
// Exemple de commande cron pour wget
*/5 * * * wget -q -O /dev/null https://demo.cocos.codes/cc_facebook_pixel?cc_facebook_pixel_cron=1&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX >/dev/null 2>&1
// Exemple de commande cron pour curl
*/5 * * * curl -s https://demo.cocos.codes/cc_facebook_pixel?cc_facebook_pixel_cron=1&key=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX >/dev/null 2>&1
Note
La mise en file d'attente des événements fonctionne également sans tâche cron externe, en utilisant le mécanisme Cron intégré de WordPress, mais une tâche cron externe permet un traitement plus fiable et plus rapide des événements.
8 Événements personnalisés
Le plug-in vous permet d'ajouter des événements JavaScript personnalisés :- Dans la section "Événements personnalisés", saisissez votre propre code d'événement.
- Sélectionnez l'endroit où insérer le code (en-tête ou pied de page)
// Exemple de code pour un événement personnalisé
fbq('track', 'MyEvent', {
parameter1 : 'value1',
parameter2 : 'value2'
}) ;Avertissement
En mode "Serveur uniquement", les événements JavaScript personnalisés ne seront pas envoyés car le code du pixel Facebook n'est pas injecté dans la page à ce moment-là. Changez le mode de suivi en mode "Hybride" ou "Navigateur uniquement" si vous souhaitez utiliser des événements JavaScript personnalisés.
9. l'appareillage avancé
La correspondance avancée permet d'envoyer des données supplémentaires sur l'utilisateur à Facebook, ce qui améliore l'efficacité du suivi :- Dans la section "Correspondance avancée", activez l'option "Activer la correspondance avancée"
- Cochez les cases des données utilisateur que vous souhaitez transférer :
- Courriel
- Téléphone
- Nom
- Nom
- Ville
- Province
- Code postal
- Pays
Conseil
La correspondance avancée fonctionne mieux lorsque les utilisateurs sont connectés à votre site. Pour les utilisateurs non connectés, le plugin essaiera de récupérer les données des formulaires qu'ils remplissent.
10. débogage
Le plug-in offre des outils de débogage complets pour aider à résoudre les problèmes d'intégration de Facebook Pixel :- Dans la section "Paramètres de débogage", activez l'option "Activer le mode de débogage"
- L'onglet "Débogage" permet d'accéder aux outils de débogage.
- Test de l'API côté serveur - envoie un événement test via l'API Conversions
- Test JavaScript Pixel - ouvre une page avec JavaScript actif Pixel
- Journaux de l'API - affiche les journaux des demandes et des réponses de l'API
Conseil
En mode débogage, le plug-in génère des journaux détaillés qui peuvent être utilisés pour diagnostiquer les problèmes. Les journaux sont enregistrés dans le répertoire /wp-content/uploads/cc-facebook-pixel-logs/.
11 Dépannage
Les événements ne sont pas envoyés- Vérifiez que vous avez saisi l'identifiant du pixel Facebook correct.
- S'assurer que la licence est active
- Vérifiez que le mode de suivi choisi est adapté à vos besoins
- Dans le cas d'un traçage côté serveur, valider le jeton d'accès.
- Activer le mode débogage et vérifier les journaux
- S'assurer que WordPress Cron fonctionne correctement
- Envisager la mise en place d'une tâche cron externe
- Vérifier que le serveur dispose des autorisations nécessaires pour envoyer des requêtes HTTP.
- Vérifier que le jeton d'accès est correct et actif
- Assurez-vous que la version correcte de l'API est sélectionnée
- Activez le mode test et vérifiez que les événements de test sont envoyés correctement.
- Vérifier les journaux de l'API pour identifier les problèmes potentiels
12. LA FAQ
Qu'est-ce que le pixel Facebook ?Facebook Pixel est un outil d'analyse qui vous permet de suivre l'activité des utilisateurs sur votre site web et d'utiliser ces données pour cibler des publicités sur Facebook, Instagram et le réseau publicitaire Audience Network.
Quelle est la différence entre le pixel JavaScript et l'API Conversions ?
JavaScript Pixel s'exécute dans le navigateur de l'utilisateur et peut être bloqué par les adblocks. L'API Conversions s'exécute sur le serveur et ne peut être bloquée par les adblocks, ce qui permet un suivi plus fiable des conversions.
Puis-je utiliser le plug-in sans licence active ?
Le plug-in fonctionnera en mode restreint sans licence active, ce qui vous permettra de visualiser les paramètres, mais vous ne pourrez pas modifier la configuration ni utiliser les fonctions avancées.
Le plug-in ralentit-il le chargement de la page ?
Le plug-in a été optimisé pour les performances. La fonction de mise en file d'attente des événements côté serveur réduit considérablement l'impact sur les temps de chargement des pages.
Le plug-in est-il conforme à RODO/GDPR ?
Le plugin lui-même ne collecte pas de données à caractère personnel, mais il permet le transfert de données à Facebook. Il incombe au propriétaire du site web d'assurer la conformité avec le RODO/GDPR, y compris l'obtention des consentements appropriés de la part des utilisateurs.
Puis-je exclure certains utilisateurs du suivi ?
Oui, sous "Paramètres de débogage", vous pouvez sélectionner les rôles d'utilisateur qui seront exclus du suivi.
Comment puis-je vérifier que le pixel Facebook fonctionne correctement ?
Activez le mode débogage et utilisez les outils de débogage pour tester l'intégration. Vous pouvez également utiliser l'extension Aide au pixel Facebook pour le navigateur Chrome.
Que se passe-t-il si je désactive la mise en file d'attente des événements ?
Les événements côté serveur seront traités de manière synchrone, ce qui peut ralentir le chargement de la page, notamment en cas de trafic important.
Où puis-je obtenir de l'aide si j'ai des problèmes avec le plug-in ?
Une assistance technique est disponible pour les détenteurs de licences. Contactez-nous via page de soutien.
