Automatické sledování e-commerce událostí
Modul podporuje kompletní sadu událostí vyžadovaných službou Google Dynamic Remarketing v retail modelu. Každá událost odesílá identifikátor produktu (items[].id) shodný s feedem Google Merchant Center a také parametr google_business_vertical: 'retail', což Googlu umožňuje přesně přiřazovat reklamy k produktům z vašeho katalogu.
| Událost Google | Kdy se spouští | Data v události |
|---|---|---|
| view_item | Stránka produktu + změna varianty (AJAX) | ID produktu, cena, business vertical |
| view_item_list | Kategorie, novinky, bestsellery, akce, výrobce, dodavatel | Seznam ID produktů, součet hodnot |
| view_search_results | Výsledky vyhledávání | Seznam ID produktů, součet hodnot |
| add_to_cart | Přidání produktu do košíku (AJAX, bez znovunačtení) | ID produktu s vybranou variantou, cena |
| purchase | Potvrzení objednávky | Seznam ID produktů, hodnota objednávky, měna |
Konfigurovatelný identifikátor produktu
Klíčovým požadavkem Googlu je shoda identifikátoru produktu v remarketingovém tagu s identifikátorem ve feedu Google Merchant Center. Modul umožňuje vybrat formát identifikátoru z 5 možností:
- ID produktu — výchozí
id_productz databáze PrestaShop - ID produktu - ID atributu — formát
id_product-id_product_attribute(pomlčka) - ID produktu _ ID atributu — formát
id_product_id_product_attribute(podtržítko) - Reference — index / katalogové číslo produktu
- EAN-13 — evropský čárový kód
U produktů s kombinacemi (variantami) modul automaticky načítá identifikátory specifické pro vybranou kombinaci — pokud má varianta vlastní EAN nebo referenci, bude do Googlu odeslán právě tento identifikátor, a ne identifikátor hlavního produktu.
Podporované stránky s výpisem produktů
Modul sleduje událost view_item_list na všech stránkách se seznamy produktů v PrestaShop:
- Stránky kategorií
- Stránky výrobce
- Stránky dodavatele
- Novinky
- Bestsellery
- Akce (slevy)
Na každé z těchto stránek se modul nejprve pokusí načíst seznam produktů z dat, která už PrestaShop načetl (proměnné Smarty), což eliminuje dodatečné SQL dotazy. Pokud data nejsou dostupná (např. nestandardní šablona), modul se automaticky přepne na přímý dotaz do databáze jako fallback.
Inteligentní sledování variant a košíku
Na stránce produktu, když zákazník změní variantu (barvu, velikost), modul odešle asynchronní AJAX požadavek na server, načte identifikátor a cenu konkrétní kombinace a poté okamžitě odešle aktualizovanou událost view_item do Googlu — bez znovunačtení stránky. Obdobně přidání produktu do košíku generuje událost add_to_cart se správným identifikátorem varianty.
Globální tag Google (gtag.js)
Modul může automaticky načíst skript gtag.js s identifikátorem konverze Google Ads a zároveň nastavit měnu a zemi obchodu. Pokud už máte nainstalovaný Google Tag Manager nebo jiný modul načítající gtag.js, můžete tuto možnost vypnout, abyste předešli duplicitě tagu — remarketingové události se budou i nadále odesílat správně.
Plná kompatibilita
- PrestaShop 1.7.x – 9.x — jeden modul pro všechny verze
- PHP 7.0 – 8.5 — bez Composeru, bez externích závislostí
- Multistore — každý obchod může mít vlastní identifikátor konverze Google Ads
- Všechny šablony — Classic, Starter Theme, Hummingbird i nestandardní šablony
- Vícejazyčnost — konfigurační panel v polštině a angličtině
Proč se vyplatí
- Jedno kliknutí — plná integrace — zadejte Google Conversion ID, uložte a hotovo; všechny události fungují automaticky na každé stránce obchodu
- Shoda s Google Merchant Center — identifikátor produktu v tagu odpovídá identifikátoru ve feedu, což umožňuje dynamické produktové reklamy se správnými obrázky a cenami
- Sledování variant v reálném čase — změna barvy, velikosti nebo jiného atributu okamžitě aktualizuje data v remarketingovém tagu, bez znovunačtení stránky
- Výkon — na stránkách s výpisem produktů modul využívá data, která už PrestaShop načetl; nulové dodatečné SQL dotazy ve standardním flow
- Bezpečnost — validace AJAX tokenů, ověření origin/referer, escapování všech proměnných v šablonách, ochrana proti CSRF a XSS
- Ověření vlastníka objednávky — událost purchase se spouští pouze pro zákazníka, který objednávku vytvořil; nehrozí únik dat objednávky
- Bez konfliktů — možnost vypnutí globálního tagu umožňuje souběžné použití s Google Tag Managerem bez duplicity skriptů
- Plné pokrytí stránek — kategorie, výrobci, dodavatelé, novinky, bestsellery, akce, vyhledávání, produkty, košík a objednávka
Požadavky
- PrestaShop 1.7.0 nebo novější (včetně 8.x a 9.x)
- PHP 7.0 nebo novější
- Účet Google Ads s aktivním dynamickým remarketingem
- Produktový feed v Google Merchant Center (pro dynamické produktové reklamy)
Instalace a konfigurace
- Nainstalujte modul přes administrativní panel PrestaShop (Moduly → Nahrát modul)
- Přejděte do konfigurace modulu
- Vložte Google Ads Conversion ID (formát:
AW-123456789) - Zvolte, zda má modul načítat globální tag
gtag.js(vypněte, pokud máte GTM) - Vyberte formát identifikátoru produktu odpovídající vašemu feedu v Google Merchant Center
- Uložte — dynamický remarketing začne okamžitě fungovat na všech stránkách obchodu