„Nic nepřichází“
Tři příčiny, v pořadí podle pravděpodobnosti:
- 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í.
- 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.
- Měření je v modulu vypnuté. Na PrestaShopu a Shopware je „Enable tracking“ ve výchozím stavu OFF.
Chyby 401
| Chyba | Příčina a náprava |
|---|---|
unknown_tenant | Web čeká na aktivaci, nebo je Site ID chybné |
invalid_signature | Tělo bylo mezi podpisem a odesláním znovu zakódováno: podepisujte přesně ty bajty, které odesíláte |
timestamp_out_of_window | Timestamp 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
- Zmizelý webhook: Shopify jej smaže po přibližně 48 hodinách selhání. Zkontrolujte Site ID v URL a vytvořte webhook znovu.
- Duplicitní objednávky: vedle webhooku „Order payment“ zůstal webhook „Order creation“. Smažte jej.
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
- Duplicitní nákupy: aktualizujte modul (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). GA4 deduplikuje pouze
purchase, a to jen podletransaction_id: novější verze už nákup z prohlížeče neodesílají. - Konverze „Unassigned“: odesílané události nesou identifikátor session a referrer, což přiřazuje konverze k jejich kanálu. Historie, kterou GA4 už zaznamenal, se nepřeřadí: náprava platí pro budoucí provoz.
„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.
- Meta, ChatGPT Ads (OpenAI) a Microsoft Advertising: 7 dní.
- GA4: z naší strany bez limitu. GA4 přijímá i starší události a přiřadí jim nové datum; je to záměrné rozhodnutí.
- Google Ads, TikTok a Pinterest: z naší strany bez limitu, rozhoduje platforma.
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.
| Stav | Vý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. |
| OK | Nic k hlášení. |
| Zpoždění | Nejstarší událost čeká déle než hodinu. |
| Ticho | Udá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