Řešení potíží

Skutečné příčiny výpadků, v pořadí, v jakém na ně narazíte. Vždy začněte tlačítkem „Diagnose my connection“ na stránce svého webu.

„Nic nepřichází“

Tři příčiny, v pořadí podle pravděpodobnosti:

  1. Souhlas. Pokud je volba „Require consent“ zapnutá a váš web nemá CMP lištu, nebo návštěvník souhlas neudělil, žádná událost neodchází: to je očekávané chování, nikoli výpadek. Neklamný příznak: tlačítko Send test event funguje (souhlas obchází), ale nic jiného nepřichází.
  2. Web nebyl nikdy aktivován. Destinace nejsou uložené, nebo nebylo nikdy kliknuto na tlačítko „Activate my tracking“: modul dostává odpovědi 401.
  3. Měření je v modulu vypnuté. Na PrestaShopu a Shopware je „Enable tracking“ ve výchozím stavu OFF.

Chyby 401

ChybaPříčina a náprava
unknown_tenantWeb čeká na aktivaci, nebo je Site ID chybné
invalid_signatureTělo bylo mezi podpisem a odesláním znovu zakódováno: podepisujte přesně ty bajty, které odesíláte
timestamp_out_of_windowTimestamp v milisekundách místo sekund, nebo nesynchronizované hodiny serveru (NTP)

Po rotaci klíče HMAC

Sběr dat je přerušen, dokud nový klíč nevložíte do modulu. Je to záměr: rotace slouží právě ke zneplatnění starého klíče.

Shopify

WordPress / WooCommerce

Po každé změně konfigurace vymažte cache webu: LiteSpeed Cache a ostatní cache pluginy jinak dál servírují starý JavaScript.

GA4

„Delivered“, ale málo atribuce

Doručená událost není automaticky atribuovaná: atribuce závisí na kvalitě párování. Obohaťte odesílaná uživatelská data: e-mail, telefon, IP a user agent, cookies fbp a gclid. Moduly DataFirefly je předávají automaticky, pokud jsou k dispozici a souhlas to umožňuje.

Okna pro přehrání

Než DataFirefly odešle událost na platformu, zkontroluje její stáří. Pravidlo platí stejně pro živou událost, pro událost opakovanou modulem i pro událost uvolněnou po pozastavení kvůli kvótě bezplatného tarifu.

Událost, která překročila okno daného cíle, se do tohoto cíle neodešle. Inspector ji zobrazí jako Not sent: too late: v okamžiku odeslání už byla starší než akceptační okno této platformy.

Fronta modulu

Když se obchod nemůže spojit s DataFirefly, modul zařadí události do fronty a odešle je znovu (viz návody pro PrestaShop, WooCommerce a Shopware). Stránka vašeho webu v klientské sekci tuto frontu ukazuje: čekající události, stáří nejstarší z nich a čas posledního hlášení modulu.

StavVýznam
Zatím bez hlášeníModul zatím nic nenahlásil. Verze starší než PrestaShop 1.29.0, WooCommerce 2.30.0 a Shopware 1.23.0 v tomto stavu zůstávají: pro zobrazení fronty modul aktualizujte.
OKNic k hlášení.
ZpožděníNejstarší událost čeká déle než hodinu.
TichoUdálosti čekaly a modul už 2 hodiny neposlal žádné hlášení.

Když fronta vyžaduje pozornost, dostanete e-mail, nejvýše jeden za 24 hodin. Pokud se zpozdí mnoho webů najednou, problém je nejspíš na straně DataFirefly: e-maily klientům se pak pozdrží a upozorněn je jen náš provozní tým.

Stále nevíte, kudy dál?

Napište nám: [email protected] a přiložte výstup tlačítka „Diagnose my connection“. Odpovídáme do jednoho pracovního dne.

Aktualizováno: 1. září 2026