# Řešení potíží

> Řešení potíží DataFirefly Server-Side: nic nepřichází, chyby 401, zmizelý webhook Shopify, duplicity v GA4, konverze Unassigned, rozdíl mezi doručením a atribucí.

- Původní stránka: https://server-side.datafirefly.com/cs/docs/troubleshooting.html
- Jazyk: cs
- Aktualizováno: 2026-09-01
- Vydavatel: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/cs/

---

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

| 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í

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](https://server-side.datafirefly.com/cs/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/cs/docs/woocommerce.html) a [Shopware](https://server-side.datafirefly.com/cs/docs/shopware.html)). 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: [support@datafirefly.com](https://server-side.datafirefly.com/cs/contact.html) a přiložte výstup tlačítka „Diagnose my connection“. Odpovídáme do jednoho pracovního dne.

Aktualizováno: 1. září 2026
