Verze 1.4.2 vyžaduje kvůli přiloženým HTTP knihovnám alespoň PHP 7.2.5; verze PHP musí splňovat také požadavky používané verze PrestaShopu. Serverové nákupy a refundace navíc vyžadují aktivní PD Cookie Pro v režimu live s Consent Mode v2, odpovídající revizi souhlasu, analytický souhlas a uložená atribuční data klienta a relace. Samotný API Secret nestačí.
Serverové purchase se neodesílá u objednávek s placeným dárkovým balením, více než 200 produktovými řádky nebo chybějící referencí/EAN při volbě takového formátu item_id. Dobropisy musí mít konzistentní částky a položky; záznamy s partial != 0 a poukazové typy se odmítají. Typ 2 je podporován pouze pro jednoznačnou refundaci samotné dopravy. Částečné vrácení množství produktů není totéž jako technický příznak partial.
Nejdůležitější vlastnosti a funkce
- 15 pojmenovaných událostí e-commerce a účtu:
view_item, view_item_list, select_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info, purchase, refund, search, view_search_results, sign_up a login.
- Volitelný
page_view: administrátor může ponechat automatické měření zobrazení stránek v modulu nebo jej vypnout, pokud měření zobrazení zajišťuje Google Tag Manager nebo jiné řešení.
- Nákup po nastaveném stavu: verze 1.4.2 odesílá purchase ze serveru po uložení stavu, který správce vybral jako potvrzení platby, do historie objednávky a po splnění ostatních podmínek. Modul sám neověřuje vypořádání u poskytovatele plateb.
- Measurement Protocol pro finanční operace: pro odeslání
purchase a refund jsou potřeba: hlavní Measurement ID, API Secret, uložená data atribuce/relace a aktuální analytický souhlas.
- Kontrolované vrácení: modul podporuje plné vrácení po vybraném stavu i nové opravy PrestaShopu, včetně částečných oprav, výhradně tehdy, pokud byl dříve zaznamenán kvalifikující nákup.
- Protokol finančních událostí: trvalý registr a zámek pro objednávku kontrolují vlastní nákupy a refundace modulu; administrace nabízí přehled pouze pro čtení s filtrováním, řazením a stránkováním. Neodstraňuje to duplicity událostí odesílaných nezávisle přes GTM nebo jiné moduly.
- Dva identifikátory Measurement ID: lze nakonfigurovat hlavní a volitelný druhý identifikátor GA4 pro události odesílané z tagu v prohlížeči.
- Pět způsobů vytváření
item_id: ID produktu, ID produktu s ID kombinace oddělené pomlčkou, ID produktu s ID kombinace oddělené podtržítkem, reference nebo EAN.
- Katalogová data u událostí: modul předává mimo jiné identifikátor, název, variantu, značku, kategorie, cenu, slevu, množství, měnu a data seznamu produktů, pokud jsou v PrestaShopu dostupná.
- Slevové kupony: podporované události prohlížeče mohou obsahovat název a kód použitého pravidla košíku. Ve verzi 1.4.2 neobsahuje serverové purchase odesílané přes Measurement Protocol kódy kuponů.
- User ID pro přihlášeného zákazníka: po zapnutí volby modul předává technický identifikátor zákazníka do GA4 při souhlasu
analytics_storage; nenahrazuje to kontaktní údaje.
- Data předávaná uživatelem: po zapnutí volby a při aktuálním souhlasu
ad_user_data může modul předat e-mail a dostupný telefon nebo adresu ve formátu vyžadovaném Googlem; identifikační údaje normalizuje a hashují pomocí SHA-256.
- Dynamický remarketing Google Ads: po zapnutí funkce a zadání identifikátoru Google Ads tag získá identifikátory produktů, typ stránky a hodnotu košíku.
- DebugView a diagnostika: režim ladění zapisuje události prohlížeče do konzole a nastavuje jejich příznak debug_mode pro GA4 DebugView. Tento příznak nenastavuje u serverových purchase a refund. Panel ukazuje stav konfigurace a poslední nákup s odpovědí HTTP 2xx; finanční události je nutné ověřit v protokolu a přehledech GA4.
- PrestaShop 1.7.x, 8.x a 9.x: tento rozsah deklaruje verze 1.4.2, nejde však o záruku pro každou verzi PHP, šablonu nebo checkout. Kód obsahuje postupy pro standardní checkout a vybrané moduly one-page checkout; je třeba ověřit skutečný průběh objednávky v daném obchodě.
Jaké fáze prodeje měří modul GA4 pro PrestaShop?
| Fáze v obchodě |
Události předávané modulem |
Rozsah dat |
| Seznamy a karta produktu |
view_item_list, select_item, view_item |
Produkt, varianta, značka, kategorie, cena, sleva a pozice v seznamu. |
| Košík |
add_to_cart, remove_from_cart, view_cart |
Položky košíku, množství, hodnoty, měna a dostupný kupón. |
| Checkout |
begin_checkout, add_shipping_info, add_payment_info |
Složení košíku a informace vybírané během procesu objednávky. |
| Nákup a vrácení |
purchase, refund |
Serverový snapshot kvalifikující transakce nebo vrácení odesílaný přes Measurement Protocol. |
| Vyhledávání a účet |
search, view_search_results, sign_up, login |
Vyhledávaný výraz, výsledky vyhledávání nebo událost vytvoření účtu a přihlášení. |
Měření nákupů a vrácení přes Measurement Protocol
V aktuálním finančním režimu modul nepovažuje kliknutí na tlačítko ani samotnou stránku potvrzení za důkaz platby. Událost purchase vzniká po uložení jednoho z vybraných platebních stavů do historie objednávky. U vrácení modul nejprve ověří, zda pro tuto objednávku existuje dřívější nákup zapsaný v deníku jako odeslaný; následně zúčtuje výhradně zbývající, nevrácenou hodnotu. Plné vrácení může spouštět vybraný stav a nové opravy PrestaShopu jsou podporovány nezávisle, také částečně.
Stav sent v deníku znamená odpověď HTTP 2xx, tedy přijetí požadavku endpointem Measurement Protocol. Nejde o potvrzení, že událost již byla zpracována nebo zobrazena v přehledech Google Analytics. Modul po aktualizaci neobnovuje historické nákupy ani vrácení a nemá automatickou frontu, CRON ani tlačítko vynucující opakování nejistého odeslání.
GA4, Google Ads, souhlasy a uživatelská data
Modul může inicializovat tag GA4 pro jedno nebo dvě Measurement ID. Pro dynamický remarketing Google Ads navíc vyžaduje identifikátor ve formátu AW-…. V aktuálním režimu nákupu podle platebního stavu se události purchase a refund odesílají do GA4 přes Measurement Protocol; modul v tomto režimu neodesílá přímou prohlížečovou konverzi nákupu do Google Ads.
Volba dat předávaných uživatelem vyžaduje aktivní PD Cookie Pro s Consent Mode v2 a aktuální souhlas ad_user_data. Vlastník obchodu navíc musí zapnout sběr takových dat ve službě GA4 i v nastavení tagu Google; konfigurace rozšířených konverzí v Google Ads je samostatný úkol na straně účtu Google. Odvolání souhlasu odstraní identifikační údaje z konfigurace tagu a serverové odesílání finančních operací před odesláním znovu ověří aktuální souhlas. User ID a údaje poskytnuté uživatelem také vyžadují aktivní PD Cookie Pro v režimu live, Consent Mode v2 a aktuální revizi souhlasu. Odvolání analytics_storage vynuluje User ID v tagu; odvolání ad_user_data vynuluje user_data. Neodstraní to data již odeslaná Googlu.
Konfigurace a ověření implementace
- Zadejte hlavní Measurement ID GA4 a druhý identifikátor pouze tehdy, pokud je potřeba.
- Pro nákupy a vrácení zadejte API Secret Measurement Protocol a vyberte stavy, které v daném obchodě skutečně potvrzují zaplacení a plné vrácení objednávky.
- Zvolte formát
item_id podle identifikátoru používaného v katalogu nebo produktovém feedu.
- Zapněte pouze potřebné funkce Google Ads, User ID a dat předávaných uživatelem po ověření nastavení a souhlasů v nástrojích Google.
- Pro test použijte režim ladění a GA4 DebugView a u finančních operací zkontrolujte deník modulu. Test je třeba provést na skutečné nákupní cestě a správném stavu objednávky.
Rozsah modulu a důležitá omezení
- Modul předává data do nakonfigurovaných služeb Google; nezakládá ani nespravuje účet GA4, Google Ads, Merchant Center ani reklamní kampaně.
- Nenahrazuje konfiguraci souhlasů ani právní analýzu obchodu. Vlastník obchodu odpovídá za právní základ zpracování dat, obsah souhlasů a nastavení účtů Google.
- Blokování skriptů, chybějící souhlas, chybějící uložená atribuce, chybné identifikátory nebo nastavení Google mohou měření omezit. Modul negarantuje úplnost dat.
- Odeslání dat pomocí API Secret vyžaduje správnou konfiguraci GA4. Odpověď HTTP 2xx je třeba chápat jako potvrzení přijetí požadavku, nikoli jako důkaz viditelnosti transakce v přehledech.
