Probleemoplossing

De echte oorzaken van storingen, in de volgorde waarin u ze tegenkomt. Begin altijd met de knop "Diagnose my connection" op de pagina van uw site.

"Er komt niets binnen"

De drie oorzaken, in volgorde van waarschijnlijkheid:

  1. De toestemming. Als de optie "Require consent" aanstaat en uw site geen CMP-banner heeft, of de bezoeker geen toestemming heeft gegeven, vertrekt er geen enkel event: dat is het verwachte gedrag, geen storing. Het onmiskenbare signaal: de knop Send test event werkt (die negeert de toestemming) maar verder komt er niets aan.
  2. De site is nooit geactiveerd. Bestemmingen niet opgeslagen, of de knop "Activate my tracking" nooit aangeklikt: de module krijgt 401-antwoorden.
  3. De tracking staat uit in de module. Op PrestaShop en Shopware staat "Enable tracking" standaard OFF.

De 401-fouten

FoutOorzaak en oplossing
unknown_tenantSite wacht op activering, of onjuiste Site ID
invalid_signatureDe body is opnieuw geëncodeerd tussen het ondertekenen en het versturen: onderteken exact de verzonden bytes
timestamp_out_of_windowTimestamp in milliseconden in plaats van seconden, of serverklok niet gesynchroniseerd (NTP)

Na een rotatie van de HMAC-sleutel

De gegevensverzameling ligt stil totdat de nieuwe sleutel in de module is geplakt. Dat is de bedoeling: de rotatie dient juist om de oude sleutel ongeldig te maken.

Shopify

WordPress / WooCommerce

Leeg na elke configuratiewijziging de cache van de site: LiteSpeed Cache en andere cache-extensies serveren anders het oude JavaScript.

GA4

"Delivered" maar weinig attributie

Een geleverd event wordt niet noodzakelijk geattribueerd: de attributie hangt af van de matchkwaliteit. Verrijk de verzonden gebruikersgegevens: e-mailadres, telefoonnummer, IP en user agent, cookies fbp en gclid. De DataFirefly-modules sturen deze automatisch mee wanneer ze beschikbaar zijn en de toestemming het toelaat.

Inhaalvensters

Voordat DataFirefly een event naar een platform stuurt, controleert het hoe oud het is. Die regel geldt voor een live event, voor een event dat een module opnieuw verstuurt en voor een event dat wordt vrijgegeven na een quotumpauze van het gratis plan.

Een event dat het venster van een bestemming heeft overschreden, wordt niet naar die bestemming gestuurd. De Inspector toont het als Not sent: too late: op het moment van verzenden was het event al ouder dan het acceptatievenster van dat platform.

De wachtrij van de module

Kan de winkel DataFirefly niet bereiken, dan zet de module de events in een wachtrij en verstuurt ze opnieuw (zie de handleidingen voor PrestaShop, WooCommerce en Shopware). De pagina van uw site in de klantenomgeving toont deze wachtrij: wachtende events, leeftijd van het oudste event, tijdstip van de laatste melding van de module.

StatusBetekenis
Nog geen meldingDe module heeft nog niets gemeld. Versies ouder dan PrestaShop 1.29.0, WooCommerce 2.30.0 en Shopware 1.23.0 blijven in deze status: werk de module bij om de wachtrij te zien.
OKNiets te melden.
AchterstandHet oudste event wacht al langer dan een uur.
StilEr wachtten events en de module heeft al 2 uur geen melding gestuurd.

Vraagt de wachtrij aandacht, dan ontvangt u een e-mail, hooguit één per 24 uur. Lopen veel sites tegelijk achter, dan ligt de storing waarschijnlijk bij DataFirefly: de e-mails aan klanten worden dan tegengehouden en alleen ons operationele team krijgt een melding.

Nog steeds vast?

Schrijf ons: [email protected], met het resultaat van de knop "Diagnose my connection" erbij. Wij antwoorden binnen een werkdag.

Bijgewerkt: 1 september 2026