Troubleshooting

The real causes of outages, in the order you meet them. Always start with the “Diagnose my connection” button on your site page.

"Nothing is coming through"

The three causes, in order of probability:

  1. Consent. If the "Require consent" option is on and your site has no CMP banner, or the visitor has not consented, no event leaves: that is the expected behaviour, not an outage. The telltale sign: the Send test event button works (it bypasses consent) but nothing else arrives.
  2. The site was never activated. Destinations not saved, or the "Activate my tracking" button never clicked: the module receives 401s.
  3. Tracking is disabled in the module. On PrestaShop and Shopware, "Enable tracking" ships OFF by default.

401 errors

ErrorCause and remedy
unknown_tenantSite awaiting activation, or wrong Site ID
invalid_signatureThe body was re-encoded between signing and sending: sign exactly the bytes you send
timestamp_out_of_windowTimestamp in milliseconds instead of seconds, or unsynced server clock (NTP)

After an HMAC key rotation

Collection stays down until the new key is pasted into the module. That is intended: rotation exists precisely to invalidate the old key.

Shopify

WordPress / WooCommerce

After any configuration change, purge the site cache: LiteSpeed Cache and other caching plugins otherwise keep serving the old JavaScript.

GA4

"Delivered" but little attribution

A delivered event is not necessarily attributed: attribution depends on match quality. Enrich the user data sent: e-mail, phone, IP and user agent, fbp and gclid cookies. DataFirefly modules pass them automatically when they are available and consent allows it.

Replay windows

Before sending an event to a platform, DataFirefly checks its age. The rule is the same for a live event, for an event replayed by a module and for an event released after a free plan quota pause.

An event past a destination's window is not sent to that destination. The Inspector shows it as Not sent: too late: at the time of sending, the event was already older than this platform's acceptance window.

The module queue

When the shop cannot reach DataFirefly, the module queues the events and replays them (see the PrestaShop, WooCommerce and Shopware guides). Your site page in the client area shows this queue: events waiting, age of the oldest one, time of the module's last report.

StateMeaning
No report yetThe module has not reported anything yet. Versions older than PrestaShop 1.29.0, WooCommerce 2.30.0 and Shopware 1.23.0 stay in this state: update to see the queue.
OKNothing to report.
LateThe oldest event has been waiting for more than an hour.
SilentEvents were waiting and the module has sent no report for 2 hours.

When the queue needs attention, you get an e-mail, at most one every 24 hours. If many sites fall behind at the same time, the incident is most likely on DataFirefly's side: client e-mails are then held back and only our operators are alerted.

Still stuck?

Write to us: [email protected], attaching the output of the "Diagnose my connection" button. We reply within one business day.

Updated: September 1, 2026