PrestaShop

Modulo CookiePilot per PrestaShop con Consent Mode v2

Carica un solo ZIP nel Module Manager, collega il dominio dello store e il modulo serve il banner dei consensi nel head di ogni pagina del negozio. Compatibile con PrestaShop da 8.0.0 a 9.99.99.

Requisiti e versioni supportate

  • PrestaShop dalla versione 8.0.0 alla 9.99.99.
  • Accesso al back office con il permesso di installare moduli.
  • Un account CookiePilot. Registrazione, verifica dell'e-mail e login si fanno direttamente nel modulo.
  • Lo ZIP del modulo, versione 1.0.0, scaricato dal link qui sotto. Non decomprimerlo.

Scarica il modulo

Lo ZIP viene servito dall'applicazione CookiePilot all'indirizzo qui sotto e non viene mai distribuito tramite marketplace di terze parti. Dopo il download confronta il checksum SHA-256 con il valore pubblicato per confermare che il file non sia stato modificato durante il transito.

Dimensione: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Scarica lo ZIP

Su Linux o macOS esegui il comando qui sotto. Su Windows usa certutil -hashfile sul file scaricato. L'output deve corrispondere esattamente al digest pubblicato.

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

Installare lo ZIP nel Module Manager

  1. 1.Nel back office apri Moduli, poi Module Manager, e clicca su Carica un modulo.
  2. 2.Trascina lo ZIP scaricato nella finestra di upload. PrestaShop lo installa e lo elenca come CookiePilot CMP.
  3. 3.Clicca su Configura sulla voce CookiePilot CMP per aprire la pagina di configurazione del modulo.
  4. 4.Se l'upload viene rifiutato, verifica che la versione di PrestaShop sia compresa tra 8.0.0 e 9.99.99 e che lo ZIP sia il file originale, non modificato.

Registrazione, verifica dell'e-mail e collegamento dello store

  1. 1.Nella pagina di configurazione crea un account CookiePilot oppure accedi a uno esistente. La registrazione richiede un indirizzo e-mail e una password.
  2. 2.Conferma l'e-mail di verifica. Il modulo completa il login una volta verificato l'indirizzo.
  3. 3.Collega lo store: il modulo crea automaticamente il dominio nel tuo account CookiePilot, oppure si ricollega a un dominio esistente con lo stesso hostname.
  4. 4.Il pannello Shop connection mostra quindi il dominio collegato, l'account e il piano attuale, con lo stato CONNECTED.

Dove viene iniettato lo script

  1. 1.Il modulo inietta lo script CookiePilot nel head di ogni pagina dello store, esattamente una volta, prima dei tag di analytics. Non incolli alcun codice nel tema, e hook duplicati in un tema non producono una seconda copia.
  2. 2.Se nel tema o in un contenitore di tag esiste già uno snippet CookiePilot incollato a mano o un altro banner di consenso, rimuovilo. Due livelli di consenso sulla stessa pagina si contendono lo stato del consenso e falsano la misurazione.
  3. 3.Il pannello Storefront status ha un solo interruttore, Enable CookiePilot banner and Consent Mode, così puoi verificare in qualsiasi momento se lo script viene servito.

Mappatura Consent Mode v2

  1. 1.Il modulo imposta i valori predefiniti di Google Consent Mode v2 su denied prima che il visitatore faccia qualsiasi scelta. Lo storage di analytics e marketing resta denied finché non esiste un consenso.
  2. 2.Accept All concede tutte le categorie. Reject All mantiene tutte le categorie su denied. Il consenso granulare concede esattamente le categorie che il visitatore ha selezionato nella vista delle impostazioni.
  3. 3.Gli script statici e dinamici opzionali registrati nel modulo vengono bloccati e rilasciati in base alle stesse categorie, quindi uno script parte solo quando la sua categoria è concessa.

Comportamento in multistore

  1. 1.In un'installazione multistore la configurazione viene salvata per singolo negozio. Ogni negozio collega il proprio dominio e conserva le proprie chiavi.
  2. 2.Un negozio appena creato non eredita le chiavi del negozio principale. Apri la configurazione del modulo nel contesto di ciascun negozio e collegalo separatamente.

Controlla il dataLayer nella console

Apri lo store in una finestra privata, apri la console del browser e incolla lo snippet qui sotto. Prima di qualsiasi scelta dovresti vedere una sola voce default con valori denied. Dopo una scelta deve seguire una voce update con le categorie concesse.

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

Test dei tracker in cinque stati

Esegui ogni stato in una sessione privata nuova e tieni aperta la scheda Network. Questi cinque stati sono il test di accettazione con cui viene verificato il modulo stesso.

Prima del consenso: con il banner ancora aperto, la scheda Network non mostra richieste di analytics o marketing e non vengono scritti cookie di tracciamento.
Solo analytics: concedi solo l'analytics nella vista granulare. Le richieste di analytics partono, le richieste e i cookie di marketing restano assenti.
Solo marketing: concedi solo il marketing. I tag di marketing possono attivarsi mentre lo storage di analytics resta denied.
Accept All: le categorie concesse partono e il dataLayer contiene un consent update con valori granted.
Reject All: lo store continua a funzionare, carrello e checkout compresi, e i tracker restano in silenzio anche dopo un ricaricamento.

Meta Pixel e TikTok Pixel non leggono Consent Mode, quindi il solo Consent Mode v2 non li ferma. Devono essere coperti dall'autoblocking del modulo oppure attivati tramite event gating solo dopo il consenso marketing.

Disattivare, disinstallare, reinstallare

La disattivazione del modulo rimuove lo script CookiePilot dallo store. Il dominio nel tuo account CookiePilot resta intatto.

La disinstallazione rimuove i secret locali e gli hook dal database del negozio. Non elimina il dominio remoto e non elimina le evidenze di consenso conservate.

Reinstallare il modulo e ricollegare lo stesso dominio funziona: il modulo si aggancia di nuovo al dominio esistente invece di crearne un duplicato.

Risoluzione dei problemi

Il banner non compare dopo l'installazione

Svuota la cache di PrestaShop in Parametri avanzati, Prestazioni, e svuota la CDN se ne usi una. L'HTML in cache continua a servire pagine generate prima dell'attivazione del modulo.

Due banner o uno stato di consenso in conflitto

Rimuovi ogni snippet di consenso incollato a mano dal tema, dagli strumenti di hosting e dai contenitori di tag. Deve girare esattamente un livello di consenso, e il modulo lo inietta già una volta.

I tracker si attivano prima del banner

Un tema o un altro modulo con GA4, Meta o TikTok inseriti a mano nel codice si carica fuori dal livello di consenso. Sposta quei tag dietro l'autoblocking del modulo o in una configurazione di tag condizionata al consenso.

Configurazioni con Google Tag Manager

Mantieni il modulo come unica fonte di consenso. Condiziona ogni tag GTM allo stato di consenso corrispondente o attivalo dopo il consent update, e non incollare mai un secondo loader CookiePilot nel contenitore.

Le richieste Meta o TikTok continuano a comparire

Questi pixel ignorano Consent Mode. Verifica che siano coperti dall'autoblocking o dall'event gating; un pixel inserito a mano nel tema continua ad attivarsi finché non viene spostato dietro il consenso marketing.

Il modulo in uno store reale

Installa il modulo e testa il tuo store

Scarica lo ZIP, collega il tuo dominio ed esegui i cinque stati del test dei tracker in una sessione pulita. Tutta la configurazione avviene nel back office.