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. Il modulo supporta PrestaShop 8.x e 9.x.

Requisiti e versioni supportate

  • Il modulo supporta PrestaShop 8.x e 9.x.
  • 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

Scarica lo ZIP ufficiale di installazione di CookiePilot, salvalo e caricalo in PrestaShop senza decomprimerlo.

Scarica lo ZIP

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 lo store usi PrestaShop 8.x o 9.x 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, torna nel PrestaShop Back Office, riapri la configurazione CookiePilot CMP e accedi con l'account verificato se necessario.
  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 inserisce uno script CookiePilot nel head di ogni pagina dello store e usa un hook anticipato del modulo. Gli script inseriti prima direttamente nel tema possono comunque avviarsi per primi, quindi configurali nel blocco automatico di CookiePilot oppure in GTM affinché attendano il consenso.
  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.

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: dopo aver accettato tutti i consensi, gli strumenti di analytics e marketing possono funzionare secondo la configurazione dello store.
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 direttamente nel codice può caricarsi fuori dal livello di consenso. Configura il blocco automatico di CookiePilot per bloccare o coprire quei tag, oppure configurali in GTM in modo che si attivino solo dopo il consenso richiesto.

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.

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.