PrestaShop

Modul CookiePilot pre PrestaShop s Consent Mode v2

Nahrajte jediný ZIP v Module Manageri, prepojte doménu obchodu a modul bude zobrazovať lištu súhlasov z head každej stránky obchodu. Podporovaný je PrestaShop 8.0.0 až 9.99.99.

Požiadavky a podporované verzie

  • PrestaShop vo verzii 8.0.0 až 9.99.99.
  • Prístup do administrácie s oprávnením inštalovať moduly.
  • Účet CookiePilot. Registrácia, overenie e-mailu aj prihlásenie prebiehajú priamo v module.
  • ZIP modulu vo verzii 1.0.0, stiahnutý z odkazu nižšie. Nerozbaľujte ho.

Stiahnutie modulu

ZIP poskytuje aplikácia CookiePilot na adrese nižšie a nikdy sa nedistribuuje cez marketplace tretích strán. Po stiahnutí porovnajte kontrolný súčet SHA-256 so zverejnenou hodnotou, aby ste potvrdili, že súbor sa cestou nezmenil.

Veľkosť: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Stiahnuť ZIP

V systéme Linux alebo macOS spustite príkaz nižšie. Vo Windows použite certutil -hashfile na stiahnutý súbor. Výstup sa musí presne zhodovať so zverejneným odtlačkom.

tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL https://app.cookiepilot.io/downloads/cookiepilot-prestashop-addons-1.0.0.zip -o "$tmp"
echo "9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9  $tmp" | sha256sum --check

Inštalácia ZIP v Module Manageri

  1. 1.V administrácii otvorte Moduly, potom Module Manager a kliknite na Nahrať modul.
  2. 2.Stiahnutý ZIP potiahnite do dialógu na nahratie. PrestaShop modul nainštaluje a v zozname ho uvedie ako CookiePilot CMP.
  3. 3.Pri položke CookiePilot CMP kliknite na Konfigurovať, čím otvoríte konfiguračnú stránku modulu.
  4. 4.Ak nahratie skončí odmietnutím, skontrolujte, či máte PrestaShop vo verzii medzi 8.0.0 a 9.99.99 a či je ZIP pôvodný, neupravený súbor.

Registrácia, overenie e-mailu a prepojenie obchodu

  1. 1.Na konfiguračnej stránke si vytvorte účet CookiePilot alebo sa prihláste do existujúceho. Na registráciu potrebujete e-mailovú adresu a heslo.
  2. 2.Potvrďte overovací e-mail. Po overení adresy modul prihlásenie dokončí.
  3. 3.Prepojte obchod: modul doménu vo vašom účte CookiePilot vytvorí automaticky alebo sa opäť pripojí k existujúcej doméne s rovnakým názvom hostiteľa.
  4. 4.Panel Shop connection potom ukáže prepojenú doménu, účet a aktuálny plán so stavom CONNECTED.

Kde sa skript vkladá

  1. 1.Modul vkladá skript CookiePilot do head každej stránky obchodu, presne raz a pred analytické tagy. Do témy nič nekopírujete a duplicitné hooky v téme druhú kópiu skriptu nespôsobia.
  2. 2.Ak sa v téme alebo v kontajneri tagov už nachádza ručne vložený snippet CookiePilot alebo iná lišta súhlasov, odstráňte ich. Dve vrstvy súhlasu na jednej stránke súperia o stav súhlasu a kazia meranie.
  3. 3.Panel Storefront status má jeden prepínač, Enable CookiePilot banner and Consent Mode, takže si kedykoľvek overíte, či sa skript práve poskytuje.

Mapovanie Consent Mode v2

  1. 1.Modul nastaví predvolené hodnoty Google Consent Mode v2 na denied skôr, než návštevník urobí akékoľvek rozhodnutie. Analytické aj marketingové úložisko ostáva denied, kým súhlas neexistuje.
  2. 2.Accept All udelí všetky kategórie. Reject All ponechá všetky kategórie denied. Granulárny súhlas udelí presne tie kategórie, ktoré si návštevník označil v nastaveniach.
  3. 3.Voliteľné statické a dynamické skripty zaregistrované v module sa blokujú a uvoľňujú podľa rovnakých kategórií, takže skript sa spustí iba vtedy, keď je jeho kategória udelená.

Správanie v multistore

  1. 1.V multistore inštalácii sa konfigurácia ukladá pre každý obchod osobitne. Každý obchod si prepája vlastnú doménu a uchováva vlastné kľúče.
  2. 2.Novovytvorený obchod nededí kľúče vlastníckeho obchodu. Konfiguráciu modulu otvorte v kontexte každého obchodu a prepojte ho samostatne.

Kontrola dataLayer v konzole

Otvorte obchod v súkromnom okne, spustite konzolu prehliadača a vložte snippet nižšie. Pred akýmkoľvek rozhodnutím by mal byť viditeľný jediný záznam default s hodnotami denied. Po rozhodnutí musí nasledovať záznam update s udelenými kategóriami.

(window.dataLayer || []).forEach(function (entry) {
  if (entry && entry[0] === 'consent') {
    console.log(entry[1], entry[2]);
  }
});

Testy trackerov v piatich stavoch

Každý stav overujte v novej súkromnej relácii a nechajte otvorenú kartu Network. Týchto päť stavov tvorí akceptačný test, ktorým sa overuje samotný modul.

Pred súhlasom: kým je lišta stále otvorená, karta Network neukazuje žiadne analytické ani marketingové požiadavky a nezapisujú sa žiadne sledovacie cookies.
Iba analytika: v granulárnom zobrazení udeľte len analytiku. Analytické požiadavky sa spustia, marketingové požiadavky a marketingové cookies sa neobjavia.
Iba marketing: udeľte len marketing. Marketingové tagy sa môžu spustiť, zatiaľ čo analytics storage ostáva denied.
Accept All: udelené kategórie sa spustia a dataLayer obsahuje consent update s hodnotami granted.
Reject All: obchod ďalej funguje vrátane košíka a pokladne a trackery ostanú ticho aj po znovunačítaní stránky.

Meta Pixel ani TikTok Pixel nečítajú Consent Mode, takže samotný Consent Mode v2 ich nezastaví. Musí ich pokryť autoblocking modulu alebo sa musia spúšťať cez event gating až po marketingovom súhlase.

Vypnutie, odinštalovanie, preinštalovanie

Vypnutie modulu odstráni skript CookiePilot z obchodu. Doména vo vašom účte CookiePilot ostane nedotknutá.

Odinštalovanie odstráni z databázy obchodu lokálne tajné údaje a hooky. Vzdialenú doménu nezmaže a nezmaže ani uložené dôkazy o súhlasoch.

Preinštalovanie modulu a opätovné prepojenie tej istej domény funguje: modul sa znova pripojí k existujúcej doméne, namiesto toho, aby vytvoril duplikát.

Riešenie problémov

Lišta sa po inštalácii nezobrazuje

Vymažte cache PrestaShopu v časti Rozšírené parametre, Výkon, a ak používate CDN, vyprázdnite aj ju. HTML v cache stále poskytuje stránky vygenerované pred zapnutím modulu.

Dve lišty alebo konfliktný stav súhlasu

Odstráňte všetky ručne vložené snippety súhlasu z témy, z nástrojov hostingu a z kontajnerov tagov. Bežať smie presne jedna vrstva súhlasu a modul ju už raz vkladá.

Trackery sa spúšťajú skôr než lišta

Téma alebo iný modul s napevno vloženým GA4, Meta alebo TikTok sa načítava mimo vrstvy súhlasu. Presuňte tieto tagy za autoblocking modulu alebo do nastavenia tagov podmieneného súhlasom.

Nasadenia s Google Tag Manager

Modul nechajte ako jediný zdroj súhlasu. Každý tag v GTM podmieňte zodpovedajúcim stavom súhlasu alebo ho spúšťajte až po consent update a do kontajnera nikdy nevkladajte druhý loader CookiePilot.

Požiadavky na Meta alebo TikTok sa stále objavujú

Tieto pixely Consent Mode ignorujú. Overte, že ich pokrýva autoblocking alebo event gating; pixel napevno vložený v téme sa spúšťa ďalej, kým ho nepresuniete za marketingový súhlas.

Modul v reálnom obchode

Nainštalujte modul a otestujte svoj obchod

Stiahnite ZIP, prepojte doménu a prejdite päť stavov testu trackerov v čistej relácii. Celé nastavenie prebehne v administrácii.