Modul je nainstalovaný, ale nic nepřichází. Proč?

Tři příčiny, popořadě: souhlas je vyžadován, ale žádná CMP lišta jej na webu nesbírá (žádná událost neodchází, což je očekávané chování); web nebyl v klientské sekci nikdy aktivován (modul dostává odpovědi 401); měření zůstalo v modulu vypnuté, protože na PrestaShopu a Shopwaru je ve výchozím stavu OFF.

Testovací událost funguje, ale nic jiného nepřichází. Proč?

To je typický příznak problému se souhlasem: tlačítko Send test event souhlas obchází, reálný provoz nikoli. Ověřte, že je vaše CMP lišta nasazená a že návštěvníci mohou souhlas udělit.

Co znamená chyba 401 unknown_tenant?

Web ještě nebyl v klientské sekci aktivován, nebo je zadané Site ID chybné. Připojte destinaci, uložte a klikněte na Activate my tracking.

Co znamená chyba 401 invalid_signature?

Tělo požadavku bylo mezi podpisem a odesláním znovu zakódováno. Serializujte JSON jen jednou, podepište přesně tento řetězec a odešlete jej beze změny.

Můj webhook Shopify zmizel. Proč?

Shopify automaticky smaže webhook po přibližně 48 hodinách nepřetržitých selhání, například když je Site ID v URL chybné. Opravte URL, vytvořte webhook znovu a sledujte Monitoring.

Proč se mé nákupy v GA4 počítají dvakrát?

GA4 deduplikuje pouze událost purchase, a to jen podle transaction_id. Aktualizujte modul (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+): novější verze už nákup z prohlížeče neodesílají.

Co se děje během pozastavení kvůli překročení kvóty na bezplatném tarifu?

Události jsou nadále přijímány, počítány a ukládány, ale nejsou doručovány. Po upgradu se přehrají v rámci akceptačních oken jednotlivých platforem: 72 hodin pro GA4, 7 dní pro Meta.

Řešení potíží | Dokumentace DataFirefly

Q: Mé události jsou Delivered, ale atribuovaných konverzí je málo. Proč?

To není problém doručení, ale kvality párování. Obohaťte odesílaná uživatelská data: e-mail, telefon, IP a user agent, cookies fbp a gclid.

„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 podle transaction_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í

Po pozastavení doručování (překročená kvóta bezplatného tarifu) se uložené události přehrají v rámci toho, co platformy akceptují: 72 hodin pro GA4, 7 dní pro Meta, jinde standardně 72 hodin. Po uplynutí je událost uchována, ale platforma ji už nepřijme.

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