PrestaShop

Modul CookiePilot pro PrestaShop s Consent Mode v2

Nahrajte jeden ZIP v Module Manageru, propojte doménu obchodu a modul začne servírovat lištu souhlasů z head každé stránky obchodu. Podporovaný PrestaShop: 8.0.0 až 9.99.99.

Požadavky a podporované verze

  • PrestaShop ve verzi 8.0.0 až 9.99.99.
  • Přístup do administrace s oprávněním instalovat moduly.
  • Účet CookiePilot. Registraci, ověření e-mailu i přihlášení zvládnete přímo v modulu.
  • ZIP modulu ve verzi 1.0.0, stažený z odkazu níže. Nerozbalujte ho.

Stažení modulu

ZIP servíruje přímo aplikace CookiePilot na níže uvedené adrese a nikdy není distribuován přes marketplace třetích stran. Po stažení porovnejte kontrolní součet SHA-256 se zveřejněnou hodnotou a ověřte, že soubor nebyl cestou změněn.

Velikost: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Stáhnout ZIP

Na Linuxu nebo macOS spusťte příkaz níže. Na Windows použijte certutil -hashfile na stažený soubor. Výstup se musí přesně shodovat se zveřejněným otiskem.

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

Instalace ZIP v Module Manageru

  1. 1.V administraci otevřete Moduly, potom Module Manager a klikněte na Nahrát modul.
  2. 2.Přetáhněte stažený ZIP do dialogu pro nahrání. PrestaShop modul nainstaluje a v seznamu ho zobrazí jako CookiePilot CMP.
  3. 3.U položky CookiePilot CMP klikněte na Konfigurovat a otevřete stránku nastavení modulu.
  4. 4.Pokud administrace nahrání odmítne, ověřte, že verze PrestaShopu leží mezi 8.0.0 a 9.99.99 a že ZIP je původní, neupravený soubor.

Registrace, ověření e-mailu a propojení obchodu

  1. 1.Na stránce nastavení si založte účet CookiePilot, nebo se přihlaste k existujícímu. K registraci stačí e-mailová adresa a heslo.
  2. 2.Potvrďte ověřovací e-mail. Jakmile je adresa ověřená, modul přihlášení dokončí.
  3. 3.Propojte obchod: modul doménu ve vašem účtu CookiePilot založí automaticky, nebo se znovu připojí k existující doméně se stejným názvem hostitele.
  4. 4.Panel Shop connection pak zobrazí propojenou doménu, účet a aktuální tarif se stavem CONNECTED.

Kam se skript vkládá

  1. 1.Modul vloží skript CookiePilot do head každé stránky obchodu, právě jednou a před analytické tagy. Do šablony nic nevkládáte a zdvojené hooky v šabloně druhou kopii skriptu nevyvolají.
  2. 2.Pokud už v šabloně nebo v kontejneru tagů máte ručně vložený snippet CookiePilot nebo jinou lištu souhlasů, odstraňte je. Dvě vrstvy souhlasu na jedné stránce si přetahují stav souhlasu a znehodnocují měření.
  3. 3.Panel Storefront status má jediný přepínač, Enable CookiePilot banner and Consent Mode, takže kdykoli ověříte, jestli se skript servíruje.

Mapování Consent Mode v2

  1. 1.Modul nastavuje výchozí hodnoty Google Consent Mode v2 na denied dřív, než návštěvník cokoli zvolí. Analytické i marketingové úložiště zůstává denied, dokud souhlas neexistuje.
  2. 2.Accept All uděluje všechny kategorie. Reject All ponechá všechny kategorie denied. Granulární souhlas udělí přesně ty kategorie, které si návštěvník vybral v nastavení.
  3. 3.Volitelné statické a dynamické skripty registrované v modulu se blokují a uvolňují podle stejných kategorií, takže skript poběží jen tehdy, když je jeho kategorie udělena.

Chování v multistore

  1. 1.V multistore instalaci se konfigurace ukládá pro každý obchod zvlášť. Každý obchod propojuje vlastní doménu a drží vlastní klíče.
  2. 2.Nově založený obchod klíče vlastnického obchodu nedědí. Otevřete konfiguraci modulu v kontextu každého obchodu a propojte jej samostatně.

Kontrola dataLayer v konzoli

Otevřete obchod v anonymním okně, otevřete konzoli prohlížeče a vložte snippet níže. Před jakoukoli volbou uvidíte jediný záznam default s hodnotami denied. Po volbě musí následovat záznam update s udělenými kategoriemi.

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

Testy trackerů v pěti stavech

Každý stav projděte v čerstvé anonymní relaci s otevřenou záložkou Network. Těchto pět stavů je akceptační test, kterým se ověřuje samotný modul.

Před souhlasem: dokud je lišta otevřená, záložka Network neukazuje žádné analytické ani marketingové požadavky a nezapisují se žádné sledovací cookies.
Jen analytika: v granulárním zobrazení udělte pouze analytiku. Analytické požadavky se rozběhnou, marketingové požadavky ani marketingové cookies se neobjeví.
Jen marketing: udělte pouze marketing. Marketingové tagy se mohou spustit, zatímco analytics storage zůstává denied.
Accept All: udělené kategorie se rozběhnou a dataLayer obsahuje consent update s hodnotami granted.
Reject All: obchod dál funguje včetně košíku a pokladny a trackery mlčí i po obnovení stránky.

Meta Pixel a TikTok Pixel Consent Mode nečtou, takže samotný Consent Mode v2 je nezastaví. Musí je pokrýt autoblocking modulu, nebo se musí spouštět přes event gating až po marketingovém souhlasu.

Vypnutí, odinstalace, přeinstalace

Vypnutí modulu odstraní skript CookiePilot z obchodu. Domény ve vašem účtu CookiePilot se to nedotkne.

Odinstalace odstraní z databáze obchodu lokální tajné údaje a hooky. Nesmaže vzdálenou doménu ani uložené doklady o souhlasech.

Přeinstalace modulu a nové propojení stejné domény fungují: modul se znovu připojí k existující doméně a duplikát nevytvoří.

Řešení potíží

Lišta se po instalaci nezobrazuje

Vymažte cache PrestaShopu v Pokročilá nastavení, Výkon, a pokud používáte CDN, promažte i tu. HTML z cache dál servíruje stránky vygenerované ještě před zapnutím modulu.

Dvě lišty nebo protichůdný stav souhlasu

Odstraňte všechny ručně vložené snippety souhlasu ze šablony, z nástrojů hostingu i z kontejnerů tagů. Běžet smí právě jedna vrstva souhlasu a modul ji už jednou vkládá.

Trackery se spouštějí před lištou

Šablona nebo jiný modul s natvrdo zapsaným GA4, Meta nebo TikTok se načítá mimo vrstvu souhlasu. Přesuňte tyto tagy za autoblocking modulu, nebo do nastavení tagů podmíněného souhlasem.

Nasazení s Google Tag Manager

Modul ponechte jako jediný zdroj souhlasu. Každý tag v GTM podmiňte odpovídajícím stavem souhlasu, nebo jej spouštějte až po consent update, a nikdy nevkládejte do kontejneru druhý loader CookiePilot.

Požadavky na Meta nebo TikTok se objevují dál

Tyto pixely Consent Mode ignorují. Ověřte, že je pokrývá autoblocking nebo event gating; pixel natvrdo zapsaný v šabloně střílí dál, dokud ho nepřesunete za marketingový souhlas.

Modul ve skutečném obchodě

Nainstalujte modul a otestujte svůj obchod

Stáhněte ZIP, propojte doménu a projděte pět stavů testu trackerů v čisté relaci. Celé nastavení proběhne v administraci.