Požadavky
- PrestaShop 1.7.6 nebo novější.
- Zip modulu, ke stažení na stránce Modules vaší klientské sekce.
- Propojovací klíč vašeho webu.
Instalace
- Back office PrestaShopu: Moduly > Správce modulů > Nahrát modul.
- Nahrajte zip tak, jak je, bez rozbalování.
- Klikněte na Konfigurovat.
Konfigurace
- Vyplňte Tenant ID, HMAC secret a Events endpoint: tři hodnoty ze stránky vašeho webu v DataFirefly.
- Volba Require consent: modul propustí událost teprve tehdy, když návštěvník přijal reklamu. Sám rozpozná, bez nastavování: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, v prohlížeči i na serveru, stejný seznam jako u modulů pro WooCommerce a Shopware. Doporučeno, pokud má váš obchod lištu souhlasu.
- Přepněte Enable tracking na Yes: ve výchozím stavu je vypnuto.
- Uložte a poté klikněte na Send test event.
Zatím na svém obchodě nemáte cookie lištu? Modul Cookie Manager pro PrestaShop nainstaluje tarteaucitron připravený k okamžitému použití, včetně Consent Mode v2.
Ověření
- Testovací událost se musí zobrazit jako Delivered v Monitoringu vaší klientské sekce.
- Vytvořte testovací objednávku: modul odesílá nákupy při potvrzení objednávky.
Fronta opakovaných odeslání
Platí od verze 1.29.0.
- Neúspěšné odeslání se zařadí do fronty a opakuje se při návštěvách obchodu: nejvýše jednou za 30 sekund, nikdy dvě opakování současně, v dávkách až 20 událostí odesílaných souběžně.
- Obchod s malou návštěvností: volitelná URL pro cron, chráněná tokenem a dostupná pouze přes https, spustí opakování bez čekání na návštěvu.
- Nákupy a refundace mají přednost, po nich nejnovější události.
- Událost z fronty odejde, až když je starší než 7 dní a zároveň čeká déle než 7 dní. Pak se započítá jako prošlá: nic nezmizí bez povšimnutí.
- Když DataFirefly neodpovídá (chyba sítě, HTTP 429 nebo 5xx), obchod na 60 sekund přestane odesílat přímo a události rovnou řadí do fronty. Výpadek na naší straně tak nikdy nezpomalí váš obchod ani pokladnu. Opakování to dál zkouší, a jakmile uspěje, přímé odesílání se obnoví.
- Stránka vašeho webu v klientské sekci ukazuje stav této fronty. Jednotlivé stavy vysvětluje stránka Řešení potíží.
Když něco nefunguje
- Logy: Pokročilá nastavení > Logy, filtrujte podle prefixu
[DataFirefly SS]. - Pokud používáte verzi modulu starší než 1.8.0, aktualizujte: novější verze opravují možné dvojí započítání nákupů v GA4.
- Další časté příčiny najdete v průvodci řešením potíží.
Aktualizováno: 1. září 2026