PrestaShop

CookiePilot modul PrestaShophoz Consent Mode v2-vel

Tölts fel egyetlen ZIP-et a Module Managerben, kösd össze a bolt domainjét, és a modul minden bolti oldal head részéből szolgálja ki a hozzájárulási sávot. Támogatott a PrestaShop 8.0.0 és 9.99.99 között.

Követelmények és támogatott verziók

  • PrestaShop 8.0.0 és 9.99.99 közötti verzió.
  • Admin hozzáférés modultelepítési jogosultsággal.
  • CookiePilot fiók. A regisztráció, az e-mail megerősítése és a bejelentkezés közvetlenül a modulban történik.
  • A modul 1.0.0 verziójú ZIP fájlja az alábbi linkről letöltve. Ne csomagold ki.

A modul letöltése

A ZIP-et az alábbi címen közvetlenül a CookiePilot alkalmazás szolgálja ki, külső marketplace-eken nem terjesztjük. Letöltés után hasonlítsd össze az SHA-256 ellenőrzőösszeget a közzétett értékkel, így megbizonyosodhatsz róla, hogy a fájl útközben nem módosult.

Méret: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
ZIP letöltése

Linuxon vagy macOS-en futtasd az alábbi parancsot. Windowson használd a certutil -hashfile parancsot a letöltött fájlon. A kimenetnek pontosan egyeznie kell a közzétett hash értékkel.

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

A ZIP telepítése a Module Managerben

  1. 1.Az adminban nyisd meg a Modulok menüt, azon belül a Module Managert, és kattints a Modul feltöltése gombra.
  2. 2.Húzd be a letöltött ZIP-et a feltöltő ablakba. A PrestaShop telepíti a modult, és CookiePilot CMP néven listázza.
  3. 3.A CookiePilot CMP bejegyzésnél kattints a Beállítás gombra a modul konfigurációs oldalának megnyitásához.
  4. 4.Ha a feltöltést a rendszer elutasítja, ellenőrizd, hogy a PrestaShop verziója 8.0.0 és 9.99.99 közé esik-e, és hogy a ZIP az eredeti, módosítatlan fájl-e.

Regisztráció, e-mail megerősítés és a bolt összekötése

  1. 1.A konfigurációs oldalon hozz létre CookiePilot fiókot, vagy jelentkezz be egy meglévőbe. A regisztrációhoz e-mail cím és jelszó kell.
  2. 2.Erősítsd meg a megerősítő e-mailt. Amint a cím megerősítése megtörtént, a modul befejezi a bejelentkezést.
  3. 3.Kösd össze a boltot: a modul automatikusan létrehozza a domaint a CookiePilot fiókodban, vagy újra csatlakozik egy azonos hosztnevű, már meglévő domainhez.
  4. 4.A Shop connection panel ezután megmutatja az összekötött domaint, a fiókot és az aktuális csomagot, CONNECTED státusszal.

Hova kerül a szkript

  1. 1.A modul a CookiePilot szkriptet minden bolti oldal head részébe szúrja be, pontosan egyszer, az analitikai tagek elé. A sablonba nem kell kódot másolnod, és a sablonban duplikált hookok sem eredményeznek második példányt.
  2. 2.Ha a sablonban vagy egy tag konténerben már van kézzel beillesztett CookiePilot snippet vagy másik hozzájárulási sáv, távolítsd el. Két consent réteg ugyanazon az oldalon egymással verseng a hozzájárulási állapotért, és elrontja a mérést.
  3. 3.A Storefront status panelen egyetlen kapcsoló van, Enable CookiePilot banner and Consent Mode, így bármikor ellenőrizheted, hogy a szkript kiszolgálása aktív-e.

Consent Mode v2 leképezés

  1. 1.A modul a Google Consent Mode v2 alapértékeit denied értékre állítja, mielőtt a látogató bármit választana. Az analitikai és a marketing tárolás denied marad, amíg nincs hozzájárulás.
  2. 2.Az Accept All minden kategóriát megad. A Reject All minden kategóriát denied állapotban tart. A részletes hozzájárulás pontosan azokat a kategóriákat adja meg, amelyeket a látogató a beállítások nézetben kiválasztott.
  3. 3.A modulban regisztrált opcionális statikus és dinamikus szkripteket ugyanezek a kategóriák blokkolják és engedik el, így egy szkript csak akkor fut, ha a kategóriája engedélyezett.

Viselkedés multistore környezetben

  1. 1.Multistore telepítésben a konfiguráció boltonként tárolódik. Minden bolt a saját domainjét köti össze, és a saját kulcsait tárolja.
  2. 2.Egy újonnan létrehozott bolt nem örökli a tulajdonos bolt kulcsait. Nyisd meg a modul konfigurációját minden bolt kontextusában, és kösd össze őket külön-külön.

A dataLayer ellenőrzése a konzolban

Nyisd meg a boltot privát ablakban, nyisd meg a böngészőkonzolt, és illeszd be az alábbi snippetet. Bármilyen választás előtt egyetlen default bejegyzést kell látnod denied értékekkel. Választás után egy update bejegyzésnek kell következnie a megadott kategóriákkal.

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

Tracker tesztek öt állapotban

Minden állapotot friss privát munkamenetben futtass, nyitott Network füllel. Ez az öt állapot az az átvételi teszt, amellyel magát a modult is ellenőrizzük.

Hozzájárulás előtt: amíg a sáv nyitva van, a Network fülön nincs analitikai vagy marketing kérés, és nem íródnak követő sütik.
Csak analitika: a részletes nézetben csak az analitikát engedélyezd. Az analitikai kérések elindulnak, marketing kérések és marketing sütik nem jelennek meg.
Csak marketing: csak a marketinget engedélyezd. A marketing tagek elsülhetnek, miközben az analytics storage denied marad.
Accept All: az engedélyezett kategóriák elindulnak, és a dataLayer tartalmaz egy consent update bejegyzést granted értékekkel.
Reject All: a bolt tovább működik, a kosárral és a pénztárral együtt, és a trackerek újratöltés után is némák maradnak.

A Meta Pixel és a TikTok Pixel nem olvassa a Consent Mode állapotát, ezért önmagában a Consent Mode v2 nem állítja meg őket. A modul autoblocking funkciójának kell lefednie őket, vagy event gating révén csak marketing hozzájárulás után szabad elsütni őket.

Kikapcsolás, eltávolítás, újratelepítés

A modul kikapcsolása eltávolítja a CookiePilot szkriptet a boltból. A CookiePilot fiókodban lévő domain érintetlen marad.

Az eltávolítás törli a helyi titkokat és a hookokat a bolt adatbázisából. Nem törli a távoli domaint, és nem törli a tárolt hozzájárulási bizonyítékokat sem.

A modul újratelepítése és ugyanannak a domainnek az újbóli összekötése működik: a modul a meglévő domainhez csatlakozik újra, nem hoz létre duplikátumot.

Hibaelhárítás

A sáv nem jelenik meg telepítés után

Ürítsd a PrestaShop gyorsítótárát a Haladó beállítások, Teljesítmény menüben, és ha CDN-t használsz, ürítsd azt is. A gyorsítótárazott HTML a modul bekapcsolása előtt generált oldalakat szolgálja ki tovább.

Két sáv vagy ellentmondó hozzájárulási állapot

Távolíts el minden kézzel beillesztett consent snippetet a sablonból, a hoszting eszközökből és a tag konténerekből. Pontosan egy consent réteg futhat, és a modul már egyszer beszúrja azt.

A trackerek a sáv előtt sülnek el

Egy sablon vagy másik modul, amely fixen tartalmazza a GA4, Meta vagy TikTok kódot, a consent rétegen kívül töltődik be. Vidd ezeket a tageket a modul autoblocking funkciója mögé, vagy hozzájáruláshoz kötött tag beállításba.

Google Tag Manager beállítások

A modul maradjon az egyetlen consent forrás. Minden GTM taget köss a megfelelő hozzájárulási állapothoz, vagy a consent update után süsd el, és soha ne illessz be második CookiePilot loadert a konténerbe.

Meta vagy TikTok kérések jelennek meg továbbra is

Ezek a pixelek figyelmen kívül hagyják a Consent Mode-ot. Ellenőrizd, hogy lefedi-e őket az autoblocking vagy az event gating; a sablonba fixen beírt pixel addig tüzel, amíg marketing hozzájárulás mögé nem kerül.

A modul egy valódi boltban

Telepítsd a modult és teszteld a boltodat

Töltsd le a ZIP-et, kösd össze a domaint, és futtasd végig az öt tracker állapotot tiszta munkamenetben. A teljes beállítás az adminban történik.