# Instalace modulu PrestaShop

> Instalace a konfigurace modulu DataFirefly Server-Side na PrestaShop 1.7.6 a novějším: nahrání zipu, propojovací klíč, souhlas tarteaucitron, testovací událost.

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

---

Kompatibilní s PrestaShop 1.7.6 a novějšími verzemi. Instalace za 5 minut ze správce modulů. Neúspěšné odeslání se zařadí do fronty a zopakuje, nákupy jako první: krátký výpadek nic nestojí.

## Požadavky

- PrestaShop 1.7.6 nebo novější.
- Zip modulu, ke stažení na stránce [**Modules**](https://admin.datafirefly.com/app/connectors) vaší klientské sekce.
- [Propojovací klíč vašeho webu](https://server-side.datafirefly.com/cs/docs/connect-your-site.html).

## Instalace

1. Back office PrestaShopu: **Moduly > Správce modulů > Nahrát modul**.
2. Nahrajte zip tak, jak je, bez rozbalování.
3. Klikněte na **Konfigurovat**.

## Konfigurace

1. Vyplňte **Tenant ID**, **HMAC secret** a **Events endpoint**: tři hodnoty ze stránky vašeho webu v DataFirefly.
2. 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.
3. Přepněte **Enable tracking** na Yes: ve výchozím stavu je vypnuto.
4. 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](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/) nainstaluje tarteaucitron připravený k okamžitému použití, včetně Consent Mode v2.

## Ověření

1. Testovací událost se musí zobrazit jako **Delivered** v Monitoringu vaší klientské sekce.
2. 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íží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

## 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íží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

Aktualizováno: 1. září 2026
