Cookies GDPR s marketingom

1. Rýchle nastavenie

V administrácii otvorte Rozšírenia → Rozšírenia → GDPR → PSoIT cookies GDPR. Pri viacerých obchodoch nastavte každý obchod samostatne.

1. Zvoľte Priamy Google tag (gtag.js), ak chcete GA4 a Google Ads spravovať týmto modulom.
2. Do Kód Analytics GA vložte vlastné ID merania G-….
3. Ak používate Google Ads, vyplňte vlastné AW-… a samostatne štítky požadovaných konverzií.
4. Zapnite GA4 e-commerce udalosti. Pre bežnú prevádzku ponechajte Ladenie GA4 vypnuté.
5. Ak používate Meta Pixel, vyplňte jeho číselné Facebook ID.
6. Vyberte stránku so zásadami cookies, nastavte farbu a prípadne tmavý vzhľad.
7. Nastavte Stav → Povolené a uložte zmeny tlačidlom s disketou vpravo hore.

2. Inštalácia a aktualizácia

1. Zálohujte súbory a nastavenia. Inštalačný balíček .ocmod.zip nahrajte cez Rozšírenia → Inštalátor.
2. Vypnite iné modifikácie zabezpečujúce meranie. Samotné vypnutie stavu pôvodného analytického modulu nemusí odstrániť jeho globálny skript.
3. Ponechajte aktívnu iba jednu verziu modifikácie psoit-gdpr-cookies. Nahraďte aj prípadnú staršiu modifikáciu cookies-head-body.
4. Obnovte Rozšírenia → Modifikácie a vymažte cache šablón.
5. Ak administrácia hlási chýbajúce oprávnenia, v skupine administrátora povoľte prístup a zmeny pre extension/extension/gdpr a extension/gdpr/cookies.
6. Vykonajte nastavenie a kontrolu podľa tohto manuálu.

Aktualizácia 3.2.0 obsahuje aj nový controller, model a JavaScript e-commerce. Samotné nahradenie modifikačného XML nestačí.

3. Prehľad polí administrácie

Nie všetky staršie jazykové položky zodpovedajú viditeľným poliam. Platnosť cookies nie je v aktuálnom formulári samostatne dostupná; jej prípadnú zmenu rieši správca v nastavení implementácie.

4. Nepoužívané služby

Nevyužívané ID nechajte prázdne. Modul bez nich príslušnú službu nezapne.

GA4, Ads a Meta možno používať samostatne aj v kombinácii. Modul zohľadňuje dostupnosť služieb v ponuke analytických a marketingových súhlasov.

5. Ako fungujú súhlasy

Google Consent Mode v2 nastavuje pred konfiguráciou značiek hodnoty analytics_storage, ad_storage, ad_user_data a ad_personalization na denied. Voľba návštevníka ich následne aktualizuje a na ďalších stránkach sa obnovuje uložený súhlas.

Google knižnica sa môže načítať už pred súhlasom. Ide o pokročilý Consent Mode: značka môže komunikovať bez cookies, zatiaľ čo ich ukladanie riadi súhlas. Výskyt gtag.js v zdrojovom kóde stránky preto sám osebe neznamená chybu.

Po odvolaní súhlasu modul aktualizuje stav, odstraňuje dostupné cookies príslušnej kategórie a obnoví stránku. Pri Meta volá aj consent revoke. Súhlasy sú v revízii 1; pri prechode zo staršej revízie 0 si ich lišta vyžiada znova.

Súhlas možno udeliť až na aktuálnej stránke produktu alebo úspešnej objednávky. Jej pripravená udalosť sa potom môže odoslať. AJAX akcie vykonané bez analytického súhlasu sa spätne neprehrávajú.

6. Google Ads konverzie

Z nastavenia príslušnej konverznej akcie Google Ads prevezmite ID značky a štítok. Napríklad:

send_to: 'AW-123456789/AbCd_Ef-123'

Google Ads ID:             AW-123456789
Konverzný štítok nákupu:    AbCd_Ef-123

Pre registráciu použite štítok jej samostatnej konverznej akcie. Modul nevyžaduje vloženie pôvodného JavaScriptového úryvku.

• Nákup: na štandardnej stránke úspechu odovzdá celkovú sumu objednávky, menu a skutočné ID objednávky ako transaction_id.
• Registrácia: zaznamená skutočné vytvorenie zákazníckeho účtu. Nejde o prihlásenie na odber newslettera ani o všeobecné kliknutie na tlačidlo.
• Súhlas: obe konverzie vyžadujú marketingový súhlas a vlastný vyplnený štítok.

Nákup znamená dokončenie objednávky v obchode. Modul tým nepotvrdzuje neskoršie skutočné zaplatenie v platobnej bráne. Google Ads konverzie a GA4 purchase sú dve samostatné udalosti pre rôzne ciele.

7. GA4 e-commerce

Zapnite prepínač GA4 e-commerce udalosti. V priamom režime stačí správne GA4 ID; v režime GTM je potrebná aj konfigurácia opísaná nižšie.

Udalosti obsahujú currency, value a items. Položka obsahuje najmä item_id (ID produktu OpenCart), item_name, jednotkovú price a quantity.

Hodnoty nákupu

transaction_id je skutočné ID objednávky. value je súčet cien položiek bez dane a dopravy; tie sú samostatne v tax a shipping. Vlastný parameter order_total obsahuje skutočný uložený celkový súčet objednávky. Pre vlastné prehľady nad týmto parametrom je potrebná zodpovedajúca vlastná metrika v GA4.

value:          34.00 EUR
shipping:        5.00 EUR
tax:             8.97 EUR
order_total:    47.97 EUR

Rozdiel medzi GA4 value a celkovou sumou nie je chyba. Google Ads naďalej dostáva celkovú sumu objednávky. Pri vlastných poplatkoch alebo neštandardných zľavách nemusí byť celková suma jednoduchým súčtom týchto troch GA4 parametrov.

Nákup vychádza z uložených položiek, meny a historického kurzu objednávky. Štandardné zľavy kupónu a vernostných bodov sa pomerne rozpočítavajú do cien produktov. Osobné údaje zákazníka, voľný text produktových volieb a údaje príjemcov poukazov sa do týchto udalostí neodovzdávajú.

AJAX a ochrana proti duplicitám

Podporované zmeny košíka fungujú cez jQuery AJAX, natívne XHR aj fetch rovnakého pôvodu. Modul vyhodnocuje skutočnú zmenu na serveri; neúspešné pridanie a nezmenené množstvo udalosť nevytvoria.

Rovnaká odpoveď sa nespracuje opakovane. Opakované potvrdenie rovnakej dopravy alebo platby pre rovnaký košík sa potláča. Nákup navyše používa skutočné transaction_id a ochranu v sessionStorage pre danú kartu, obchod a cieľ. Pri nedostupnom úložisku zostáva ochrana v pamäti stránky a ID transakcie pre Google.

Podporovaný je štandardný checkout OpenCart a zmeny množstva cez advanced_popup_cart/edit. Iný vlastný checkout alebo iné serverové endpointy môžu vyžadovať doplnenie integrácie.

8. Meta Pixel

Do Facebook ID vložte iba číselné ID Pixelu z Meta Events Managera. Po marketingovom súhlase sa načíta fbevents.js, vykoná sa inicializácia a jeden štandardný fbq('track', 'PageView') na stránku.

Pred marketingovým súhlasom sa Pixel nenačítava. Funguje aj bez Google služieb. Nepodmienený obrázok noscript nie je vložený, aby neobchádzal súhlas; bez JavaScriptu sa Meta meranie neposiela.

9. Voliteľný režim Google Tag Manager

Zvoľte ho, ak GA4 spravujete v GTM. Vyplňte ID kontajnera a publikujte v ňom Google tag pre vlastné GA4 ID. Samotný prázdny kontajner GA4 meranie nezabezpečuje. Pole GA4 v module sa v tomto režime nepoužíva.

Modul vkladá e-commerce objekty do dataLayer a pred každou udalosťou predchádzajúci objekt ecommerce vyčistí. Nastavte jednu GA4 Event značku:

1. Spúšťač typu Custom Event s regulárnym výrazom nižšie; zapnite použitie regulárneho výrazu.
2. Názov udalosti nastavte na vstavanú premennú {{Event}}.
3. Vytvorte Data Layer premenné verzie 2 a mapujte nižšie uvedené parametre.
4. Pre túto e-commerce značku vyžadujte súhlas analytics_storage, overte náhľadom a publikujte zmeny.

^(view_item|add_to_cart|remove_from_cart|view_cart|begin_checkout|add_shipping_info|add_payment_info|purchase)$

10. Overenie merania

1. Dočasne zapnite Ladenie GA4 (DebugView) a otvorte obchod v novom testovacom okne.
2. Overte odmietnutie, samotnú analytiku, samotný marketing a povolenie všetkého. Pre jednotlivé scenáre použite čistú testovaciu reláciu alebo zmenu voľby v nastavení cookies.
3. S analytickým súhlasom prejdite produkt, pridanie do košíka, zmenu množstva, košík, dopravu, platbu a novú testovaciu objednávku.
4. V Chrome otvorte F12 → Console a použite príkazy nižšie. V režime ladenia uvidíte aj záznamy s prefixom [PSoIT GA4].
5. V Network sledujte požiadavky collect. Prijatie e-commerce udalostí overte v GA4 → Administrátor → DebugView; v režime GTM musí byť namapovaný aj debug_mode.
6. Ads overte pomocou Tag Assistantu a správneho konverzného cieľa. Meta overte po marketingovom súhlase pomocou Meta Pixel Helpera alebo testovacích udalostí v Events Manageri.
7. Po overení vypnite ladenie GA4.

Stav a udalosti aktuálnej stránky

window.psoitGa4?.getStatus()
window.psoitGa4?.getEvents()

Udalosti v priamom režime gtag.js

Array.from(window.dataLayer || [])
  .filter(x => x && x[0] === 'event')
  .map(x => ({ event: x[1], params: x[2] }))

Udalosti v režime GTM

(window.dataLayer || [])
  .filter(x => x && x.event && x.ecommerce)

Na ladenie iba jednej stránky možno k jej URL pridať gdpr_debug=1, napríklad index.php?route=product/product&product_id=28&gdpr_debug=1. Pre celý nákupný priechod použite prepínač v administrácii.

11. Riešenie problémov

12. Kontrola pred spustením

• Všetky vyplnené ID a konverzné štítky patria správnemu obchodu a účtu.
• Nepoužívané služby majú prázdne polia; nie je aktívna pôvodná Adwords modifikácia ani duplicitné odosielanie z iných modulov.
• Zásady cookies zodpovedajú zapnutým službám a stránka je vybraná v administrácii.
• Overili ste jednotlivé kategórie súhlasu aj jeho odvolanie.
• GA4 prijalo testovacie udalosti so správnymi položkami, menou a ID objednávky.
• Po obnovení úspešnej objednávky nevznikol ďalší nákup; Ads a Meta smerujú do správnych účtov.
• Ladenie GA4 je pre bežnú prevádzku vypnuté a nastavenia sú uložené pre každý používaný obchod.