« Rien ne remonte »
Les trois causes, dans l'ordre des probabilités :
- Le consentement. Si l'option « Require consent » est active et que votre site n'a pas de bannière CMP, ou que le visiteur n'a pas consenti, aucun événement ne part : c'est le comportement attendu, pas une panne. L'indice qui ne trompe pas : le bouton Send test event fonctionne (il passe outre le consentement) mais rien d'autre n'arrive.
- Le site n'a jamais été activé. Destinations non enregistrées, ou bouton « Activate my tracking » jamais cliqué : le module reçoit des 401.
- Le tracking est désactivé dans le module. Sur PrestaShop et Shopware, « Enable tracking » est OFF par défaut.
Les erreurs 401
| Erreur | Cause et remède |
|---|---|
unknown_tenant | Site en attente d'activation, ou Site ID erroné |
invalid_signature | Le corps a été ré-encodé entre la signature et l'envoi : signez exactement les octets envoyés |
timestamp_out_of_window | Timestamp en millisecondes au lieu de secondes, ou horloge du serveur non synchronisée (NTP) |
Après une rotation de la clé HMAC
La collecte est coupée tant que la nouvelle clé n'est pas collée dans le module. C'est voulu : la rotation sert précisément à invalider l'ancienne clé.
Shopify
- Webhook disparu : supprimé par Shopify après environ 48 heures d'échecs. Vérifiez le Site ID dans l'URL, recréez le webhook.
- Commandes en double : un webhook « Order creation » subsiste à côté du « Order payment ». Supprimez-le.
WordPress / WooCommerce
Après toute modification de configuration, purgez le cache du site : LiteSpeed Cache et les autres extensions de cache servent sinon l'ancien JavaScript.
GA4
- Achats en double : mettez le module à jour (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). GA4 ne déduplique que
purchase, et uniquement partransaction_id: les versions récentes n'envoient plus l'achat côté navigateur. - Conversions « Unassigned » : les événements envoyés portent l'identifiant de session et le référent, ce qui rattache les conversions à leur canal. L'historique déjà enregistré par GA4 ne se reclasse pas : le rattachement vaut pour le trafic à venir.
« Delivered » mais peu d'attribution
Un événement livré n'est pas forcément attribué : l'attribution dépend de la qualité de correspondance. Enrichissez les données utilisateur envoyées : e-mail, téléphone, IP et user agent, cookies fbp et gclid. Les modules DataFirefly les transmettent automatiquement quand elles sont disponibles et que le consentement le permet.
Fenêtres de rattrapage
Avant d'envoyer un événement à une plateforme, DataFirefly vérifie son âge. La règle est la même pour un événement en direct, pour un événement rejoué par un module et pour un événement libéré après une pause de quota du plan gratuit.
- Meta, ChatGPT Ads (OpenAI) et Microsoft Advertising : 7 jours.
- GA4 : aucune limite de notre côté. GA4 accepte les événements plus anciens et leur attribue une nouvelle date ; ce choix est délibéré.
- Google Ads, TikTok et Pinterest : aucune limite de notre côté, la plateforme décide.
Un événement qui a dépassé la fenêtre d'une destination n'est pas envoyé à cette destination. L'Inspecteur l'affiche en Not sent: too late : au moment de l'envoi, l'événement était déjà plus ancien que la fenêtre d'acceptation de cette plateforme.
La file d'attente du module
Quand la boutique ne parvient pas à joindre DataFirefly, le module met les événements en file et les rejoue (voir les guides PrestaShop, WooCommerce et Shopware). La page de votre site, dans l'espace client, affiche cette file : événements en attente, âge du plus ancien, heure du dernier rapport du module.
| État | Signification |
|---|---|
| Pas encore de rapport | Le module n'a encore rien signalé. Les versions antérieures à PrestaShop 1.29.0, WooCommerce 2.30.0 et Shopware 1.23.0 restent dans cet état : mettez à jour pour voir la file. |
| OK | Rien à signaler. |
| En retard | L'événement le plus ancien attend depuis plus d'une heure. |
| Silencieux | Des événements attendaient et le module n'a envoyé aucun rapport depuis 2 heures. |
Quand la file demande votre attention, vous recevez un e-mail, au plus un par 24 heures. Si beaucoup de sites passent en retard en même temps, l'incident est probablement chez DataFirefly : les e-mails aux clients sont alors retenus et seule notre équipe d'exploitation est alertée.
Toujours bloqué ?
Écrivez-nous : [email protected], en joignant le résultat du bouton « Diagnose my connection ». Nous répondons sous un jour ouvré.
Mise à jour : 1 septembre 2026