# Dépannage

> Dépanner DataFirefly Server-Side : rien ne remonte, erreurs 401, webhook Shopify disparu, doublons GA4, conversions Unassigned, écart entre livraison et attribution.

- Page d'origine : https://server-side.datafirefly.com/docs/troubleshooting.html
- Langue : fr
- Mis à jour le : 2026-09-01
- Éditeur : DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/

---

Les causes réelles des pannes, dans l'ordre où on les rencontre. Commencez toujours par le bouton « Diagnose my connection » de la page de votre site.

## « Rien ne remonte »

Les trois causes, dans l'ordre des probabilités :

1. **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.
2. **Le site n'a jamais été activé.** Destinations non enregistrées, ou bouton « Activate my tracking » jamais cliqué : le module reçoit des 401.
3. **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 par `transaction_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](https://server-side.datafirefly.com/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/docs/woocommerce.html) et [Shopware](https://server-side.datafirefly.com/docs/shopware.html)). 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 : [support@datafirefly.com](https://server-side.datafirefly.com/contact.html), en joignant le résultat du bouton « Diagnose my connection ». Nous répondons sous un jour ouvré.

Mise à jour : 1 septembre 2026
