Prérequis
- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatible HPOS.
- Le zip du plugin, à télécharger depuis la page Modules de votre espace client.
- La clé de connexion de votre site.
Installation
- Admin WordPress : Extensions > Ajouter > Téléverser une extension.
- Envoyez le zip, puis cliquez Activer.
Configuration
- Ouvrez Réglages > DataFirefly Server-Side.
- Collez la clé de connexion
dfss_...et cliquez Connect : le bouton active le tracking complet et l'option de consentement, et déclenche un événement de test dans la foulée.
Le plugin détecte automatiquement les outils de consentement suivants, sans réglage : WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. La même détection est utilisée par les modules PrestaShop et Shopware : un outil reconnu ici l'est partout.
Ce que le plugin couvre
- Tout le tunnel : navigation, vue produit, panier, checkout, achat.
- Déduplication par identifiant de commande : pas de double comptage entre navigateur et serveur.
- File de renvoi automatique : les envois échoués sont rejoués, les achats en premier (détails ci-dessous).
- Le panneau DataFirefly Activity dans l'admin montre les derniers événements envoyés.
Vérifier
- L'événement de test doit apparaître en Delivered dans le Monitoring de votre espace client.
- Passez une commande de test et retrouvez-la dans le panneau DataFirefly Activity.
File de renvoi
Comportement des versions 2.30.0 et suivantes.
- Un envoi échoué est mis en file, puis rejoué toutes les 5 minutes par WP-Cron.
- Les achats et les remboursements passent en premier, puis les événements les plus récents.
- Un événement ne sort de la file que s'il a plus de 7 jours et attend depuis plus de 7 jours. Il est alors compté comme expiré : rien ne disparaît en silence.
- Si DataFirefly ne répond pas (panne réseau, erreur HTTP 429 ou 5xx), la boutique cesse d'envoyer en direct pendant 60 secondes et met les événements directement en file. Une panne chez nous ne ralentit donc jamais votre boutique ni le checkout. Le rejeu continue d'essayer, et dès qu'il réussit, l'envoi direct reprend.
- La page de votre site, dans l'espace client, affiche l'état de cette file. Les états sont expliqués dans le guide de dépannage.
En cas de problème
- Après un changement de configuration, purgez le cache de votre site : LiteSpeed Cache et consorts servent sinon l'ancien JavaScript.
- Si vous utilisez une version du plugin antérieure à 2.8.0, mettez à jour : les versions récentes corrigent un double comptage possible des achats dans GA4.
- Les autres causes fréquentes sont listées dans le guide de dépannage.
Mise à jour : 1 septembre 2026