PrestaShop

CookiePilot modul za PrestaShop s Consent Mode v2

Ucitajte jedan ZIP u Module Manageru, povezite domenu trgovine i modul ce posluzivati banner privole iz head sekcije svake stranice trgovine. Podrzan je PrestaShop od 8.0.0 do 9.99.99.

Preduvjeti i podrzane verzije

  • PrestaShop u verziji od 8.0.0 do 9.99.99.
  • Pristup administraciji trgovine s ovlastima za instalaciju modula.
  • CookiePilot racun. Registracija, potvrda e-maila i prijava obavljaju se izravno u modulu.
  • ZIP datoteka modula, verzija 1.0.0, preuzeta s poveznice u nastavku. Nemojte je raspakirati.

Preuzmite modul

ZIP posluzuje aplikacija CookiePilot na adresi u nastavku i ne distribuira se putem vanjskih marketplacea. Nakon preuzimanja usporedite SHA-256 sazetak s objavljenom vrijednoscu kako biste potvrdili da datoteka nije izmijenjena tijekom prijenosa.

Velicina: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Preuzmi ZIP

Na Linuxu ili macOS-u pokrenite naredbu u nastavku. Na Windowsu upotrijebite certutil -hashfile nad preuzetom datotekom. Rezultat se mora tocno podudarati s objavljenim sazetkom.

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

Instalacija ZIP-a u Module Manageru

  1. 1.U administraciji otvorite Moduli, zatim Module Manager i kliknite Upload a module.
  2. 2.Povucite preuzeti ZIP u dijalog za upload. PrestaShop instalira modul i prikazuje ga na popisu kao CookiePilot CMP.
  3. 3.Kliknite Configure na stavci CookiePilot CMP kako biste otvorili stranicu konfiguracije modula.
  4. 4.Ako upload bude odbijen, provjerite je li verzija PrestaShopa izmedu 8.0.0 i 9.99.99 te je li ZIP izvorna, neizmijenjena datoteka.

Registracija, potvrda e-maila i povezivanje trgovine

  1. 1.Na stranici konfiguracije otvorite CookiePilot racun ili se prijavite na postojeci. Za registraciju su potrebni e-mail adresa i lozinka.
  2. 2.Potvrdite verifikacijski e-mail. Modul dovrsava prijavu cim je adresa potvrdena.
  3. 3.Povezite trgovinu: modul automatski kreira domenu na vasem CookiePilot racunu ili se ponovno poveze s postojecom domenom istog naziva hosta.
  4. 4.Panel Shop connection tada prikazuje povezanu domenu, racun i trenutni plan, sa statusom CONNECTED.

Gdje se skripta ubacuje

  1. 1.Modul ubacuje CookiePilot skriptu u head svake stranice trgovine, tocno jednom, prije analitickih tagova. Nikada ne lijepite kod u temu, a duplicirani hookovi u temi ne stvaraju drugu kopiju skripte.
  2. 2.Ako u temi ili u tag kontejneru vec postoji rucno zalijepljen CookiePilot snippet ili drugi banner privole, uklonite ga. Dva sloja privole na istoj stranici bore se za stanje privole i kvare mjerenje.
  3. 3.Panel Storefront status ima jedan prekidac, Enable CookiePilot banner and Consent Mode, pa u svakom trenutku mozete provjeriti posluzuje li se skripta.

Mapiranje Consent Mode v2

  1. 1.Modul postavlja zadane vrijednosti Google Consent Mode v2 na denied prije nego sto posjetitelj donese bilo kakvu odluku. Analiticka i marketinska pohrana ostaju denied dok privola ne postoji.
  2. 2.Accept All odobrava sve kategorije. Reject All zadrzava sve kategorije na denied. Granularna privola odobrava tocno one kategorije koje je posjetitelj odabrao u prikazu postavki.
  3. 3.Neobavezne staticke i dinamicke skripte registrirane u modulu blokiraju se i oslobadaju po istim kategorijama, pa se skripta pokrece samo kada je njezina kategorija odobrena.

Ponasanje u multistoreu

  1. 1.U multistore instalaciji konfiguracija se sprema po trgovini. Svaka trgovina povezuje vlastitu domenu i cuva vlastite kljuceve.
  2. 2.Novokreirana trgovina ne nasljeduje kljuceve vlasnicke trgovine. Otvorite konfiguraciju modula u kontekstu svake trgovine i povezite je zasebno.

Provjera dataLayera u konzoli

Otvorite trgovinu u privatnom prozoru, otvorite konzolu preglednika i zalijepite snippet u nastavku. Prije bilo kakve odluke trebali biste vidjeti jedan default zapis s vrijednostima denied. Nakon odluke mora slijediti update zapis s odobrenim kategorijama.

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

Testovi trackera u pet stanja

Svako stanje provedite u svjezoj privatnoj sesiji s otvorenom karticom Network. Tih pet stanja cini prihvatni test prema kojem se provjerava i sam modul.

Prije privole: dok je banner jos otvoren, kartica Network ne prikazuje analiticke ni marketinske zahtjeve i ne zapisuju se kolacici za pracenje.
Samo analitika: u granularnom prikazu odobrite iskljucivo analitiku. Analiticki zahtjevi krecu, a marketinski zahtjevi i marketinski kolacici izostaju.
Samo marketing: odobrite iskljucivo marketing. Marketinski tagovi smiju se aktivirati, dok analiticka pohrana ostaje denied.
Accept All: odobrene kategorije krecu, a dataLayer sadrzi consent update s vrijednostima granted.
Reject All: trgovina i dalje radi, ukljucujuci kosaricu i checkout, a trackeri ostaju tihi i nakon ponovnog ucitavanja stranice.

Meta Pixel i TikTok Pixel ne citaju Consent Mode, pa ih sam Consent Mode v2 ne zaustavlja. Moraju biti obuhvaceni autoblockingom modula ili se aktivirati putem event gatinga tek nakon marketinske privole.

Iskljucivanje, deinstalacija, ponovna instalacija

Iskljucivanje modula uklanja CookiePilot skriptu iz trgovine. Domena na vasem CookiePilot racunu ostaje netaknuta.

Deinstalacija uklanja lokalne tajne i hookove iz baze trgovine. Ne brise udaljenu domenu i ne brise pohranjene dokaze o privolama.

Ponovna instalacija modula i ponovno povezivanje iste domene funkcioniraju: modul se ponovno veze na postojecu domenu umjesto da stvara duplikat.

Rjesavanje problema

Banner se ne pojavljuje nakon instalacije

Ocistite PrestaShop cache pod Napredni parametri, Performanse, i ispraznite CDN ako ga koristite. Keširani HTML i dalje posluzuje stranice generirane prije ukljucivanja modula.

Dva bannera ili proturjecno stanje privole

Uklonite sve rucno zalijepljene snippete privole iz teme, alata hostinga i tag kontejnera. Smije raditi tocno jedan sloj privole, a modul ga vec ubacuje jednom.

Trackeri se aktiviraju prije bannera

Tema ili drugi modul s tvrdo upisanim GA4, Meta ili TikTok tagovima ucitava se izvan sloja privole. Premjestite te tagove iza autoblockinga modula ili u tag konfiguraciju uvjetovanu privolom.

Postavke s Google Tag Managerom

Modul mora ostati jedini izvor privole. Uvjetujte svaki GTM tag odgovarajucim stanjem privole ili ga aktivirajte nakon consent updatea i nikada ne lijepite drugi CookiePilot loader u kontejner.

Zahtjevi prema Meta ili TikTok i dalje se pojavljuju

Ti pikseli ignoriraju Consent Mode. Provjerite jesu li obuhvaceni autoblockingom ili event gatingom; piksel tvrdo upisan u temu nastavlja se aktivirati dok se ne premjesti iza marketinske privole.

Modul u stvarnoj trgovini

Instalirajte modul i testirajte trgovinu

Preuzmite ZIP, povezite domenu i prodite pet stanja testa trackera u cistoj sesiji. Cijelo postavljanje odvija se u administraciji trgovine.