PS PrestaShop Principiante

Cookie Manager Tarteaucitron — Guida completa

Installazione, procedura guidata, blocco automatico degli script di terze parti, elenco dei cookie, catalogo di servizi, aspetto, Google Consent Mode v2, analisi, statistiche e prova dei consensi del modulo Cookie Manager (tarteaucitron.js) per PrestaShop 1.7.8, 8 e 9.

Aggiornato Versione del modulo 3.0.0

Presentazione

Cookie Manager è un modulo di gestione del consenso ai cookie per PrestaShop 1.7.8, 8 e 9, compatibile con i temi Classic e Hummingbird. Si basa su tarteaucitron.js 1.37.0, la libreria open source di Amauri Champeaux (licenza MIT). Il modulo vi aggiunge il proprio banner, il blocco automatico degli script di terze parti, un elenco dei cookie generato per i tuoi visitatori, Google Consent Mode v2 e un registro di prova dei consensi.

Finché il visitatore non ha scelto nulla, il modulo non installa alcun cookie, non scrive nulla nello storage del browser e non contatta alcuna terza parte. Il cookie che memorizza la scelta viene scritto solo al primo clic.

Banner dei cookie nella home page di un negozio PrestaShop 9 (tema Hummingbird): «Rifiuta tutto» e «Accetta tutto» con lo stesso aspetto
Banner dei cookie nella home page di un negozio PrestaShop 9 (tema Hummingbird): «Rifiuta tutto» e «Accetta tutto» con lo stesso aspetto

Installazione e procedura guidata iniziale

  1. Nel back-office, apri Moduli → Gestione moduli → Carica un modulo.
  2. Carica il file datafirefly_tarteaucitron-3.0.0.zip, poi clicca su Configura.
  3. La procedura guidata si apre alla prima visualizzazione: informativa sulla privacy, strumenti utilizzati e relativi identificativi, aspetto, attivazione del banner.

La configurazione è accessibile anche dalla voce di menu Moduli → Cookies (tarteaucitron). La procedura guidata può essere riavviata in qualsiasi momento con il pulsante Procedura guidata in cima alla pagina.

Procedura guidata di configurazione in 4 passaggi: scelta degli strumenti usati dal negozio e inserimento dei loro ID
Procedura guidata di configurazione in 4 passaggi: scelta degli strumenti usati dal negozio e inserimento dei loro ID

Aggiornamento dalla versione 2.0 o 1.x

Carica il nuovo zip sopra il vecchio modulo. Lo script di aggiornamento recupera le tue impostazioni: servizi e identificativi, testi, colori, posizione, durata, Consent Mode, registro, statistiche e servizi personalizzati.

  • La scelta già espressa dai tuoi visitatori con la 2.0 viene conservata: il banner non viene mostrato loro di nuovo, a meno che tu non aggiunga un servizio.
  • Il blocco automatico resta disattivato dopo un aggiornamento. Attivalo nella scheda Blocco, poi testa le tue pagine.
  • Dalla 1.x, il valore unico di ogni testo viene copiato in tutte le lingue del negozio, e l’etichetta «Continua senza accettare» diventa «Rifiuta tutto».

Su una nuova installazione, il blocco automatico è attivato per impostazione predefinita.

Dashboard

La dashboard riunisce dodici controlli di configurazione: banner attivato, link all’informativa sulla privacy, pulsanti «Rifiuta tutto» e «Accetta tutto» con lo stesso aspetto, durata della scelta, modalità di revoca, valori predefiniti di Consent Mode, identificativi validi, file serviti dal negozio, analisi degli script di terze parti, blocco automatico, elenco dei cookie accessibile al visitatore e registro di prova. Ogni punto non soddisfatto propone un link Correggi verso la scheda giusta.

Questi controlli riprendono buone pratiche tratte dalle raccomandazioni della CNIL e dell’EDPB. Aiutano a configurare il banner ma non sostituiscono l’analisi giuridica del tuo sito.

Dashboard del banner dei cookie: controllo della configurazione in 12 punti, dati degli ultimi 30 giorni e servizi gestiti
Dashboard del banner dei cookie: controllo della configurazione in 12 punti, dati degli ultimi 30 giorni e servizi gestiti

Servizi

La scheda Servizi presenta il catalogo verificato: Google Analytics 4, Google Tag Manager, Google Ads, Meta Pixel, TikTok, LinkedIn Insight, Pinterest, Snap Pixel, Microsoft Advertising, Microsoft Clarity, Hotjar, Matomo, Plausible, HubSpot, YouTube, Vimeo, Google Maps, Intercom, Crisp, Tawk.to, Smartsupp e Stripe, oltre a due segnali Google Consent Mode senza script, per un tag Google installato da un altro modulo.

  • Attiva solo gli strumenti realmente presenti sul tuo negozio e incolla il loro identificativo: il formato viene verificato durante l’inserimento e poi al salvataggio. Un identificativo non valido viene rifiutato e il servizio resta disattivato.
  • Ogni servizio può essere associato a una categoria diversa da quella proposta, ad esempio Google Tag Manager in «Pubblicità» se il tuo contenitore contiene soprattutto tag pubblicitari.
  • Matomo e Plausible possono essere dichiarati esenti dal consenso, solo se la tua configurazione dello strumento rispetta le condizioni della CNIL per la misurazione dell’audience.
  • Stripe è trattato come strettamente necessario per il pagamento: viene caricato senza richiesta e mostrato tra i cookie sempre attivi.

Servizi personalizzati: per uno strumento assente dal catalogo, aggiungi un servizio con il suo nome, la sua categoria, la sua informativa sulla privacy, i suoi cookie e il codice fornito dallo strumento (tag <script> inclusi). Questo codice viene eseguito solo dopo il consenso del visitatore per la categoria scelta.

Catalogo di 24 servizi verificati: ID controllati all’inserimento, categoria mostrata al visitatore, ricerca e filtri
Catalogo di 24 servizi verificati: ID controllati all’inserimento, categoria mostrata al visitatore, ricerca e filtri

Libreria tarteaucitron.js: i 245 servizi di tarteaucitron.js 1.37.0 sono disponibili in aggiunta al catalogo. Cerca un servizio, aggiungilo, inserisci i suoi parametri e scegli la sua categoria. Il file di un servizio viene scaricato dal visitatore solo se il servizio è attivato e accettato.

Libreria tarteaucitron.js: ricerca tra 245 servizi aggiuntivi e aggiunta di un servizio con un solo clic
Libreria tarteaucitron.js: ricerca tra 245 servizi aggiuntivi e aggiunta di un servizio con un solo clic

Blocco automatico

Prima dell’invio di ogni pagina, il modulo neutralizza i tag <script> e gli iframe dei servizi di terze parti che riconosce, che provengano dal tema o da un altro modulo: 46 servizi (quelli del catalogo e altri 24 tracker comuni), più le tue regole. Nulla viene scaricato né eseguito finché il visitatore non ha accettato la categoria corrispondente; i tag vengono poi riattivati nell’ordine del documento.

  • Regole aggiuntive: una regola per riga, nel formato frammento di indirizzo o di codice | nome mostrato al visitatore | categoria. Le categorie sono analytic, ads, social e functional. Il pulsante «Blocca» dell’analisi aggiunge la regola al posto tuo.
  • Eccezioni: un frammento per riga; un tag il cui indirizzo o codice lo contiene non viene mai bloccato. Puoi anche aggiungere l’attributo data-dftac-ignore a un tag del tuo tema.

Il blocco riguarda i tag presenti nel codice della pagina. Uno script caricato da un altro script (ad esempio da un file JavaScript di un modulo) non vi compare: disattivalo in quel modulo e dichiara il servizio qui. Uno script che utilizza document.write può non funzionare una volta riattivato.

Google Tag Manager viene bloccato per intero fino al consenso. Se lo gestisci con il Consent Mode, aggiungi googletagmanager.com/gtm.js alle eccezioni.

Blocco automatico degli script di terze parti e dei contenuti incorporati prima del consenso: impostazioni, regole aggiuntive, eccezioni e limiti
Blocco automatico degli script di terze parti e dei contenuti incorporati prima del consenso: impostazioni, regole aggiuntive, eccezioni e limiti

La scheda Cookie genera l’elenco dei cookie a partire dai servizi attivati, dai tag bloccati e dalle tue aggiunte: categoria, servizio, nome, durata e finalità. Viene aggiornato a ogni salvataggio e mostrato nella lingua del visitatore.

  • Cookie aggiuntivi: un cookie per riga, nel formato nome | fornitore | durata | finalità | categoria, per i cookie dei tuoi altri moduli o per precisare una durata.
  • Una durata viene indicata solo se è stata rilevata nella documentazione del fornitore (novembre 2026); «—» significa che è stabilita dal servizio.

Verifica questo elenco prima di pubblicarlo: descrive i servizi dichiarati nel modulo, non quelli che un altro script aggiungerebbe a tua insaputa.

Elenco dei cookie generato automaticamente: categoria, servizio, nome, durata e finalità di ogni cookie, cookie aggiuntivi
Elenco dei cookie generato automaticamente: categoria, servizio, nome, durata e finalità di ogni cookie, cookie aggiuntivi

Con l’opzione Pubblica l’elenco dei cookie (scheda Comportamento), viene creata una pagina pubblica, collegata dal banner, dalla finestra delle preferenze e dal piè di pagina.

Pagina pubblica «Elenco dei cookie»: cookie ordinati per finalità con durata e finalità, pulsante «Gestisci i miei cookie»
Pagina pubblica «Elenco dei cookie»: cookie ordinati per finalità con durata e finalità, pulsante «Gestisci i miei cookie»

Aspetto

Sono proposti sei layout: banner largo in basso, riquadro in uno dei quattro angoli o finestra al centro. Per impostazione predefinita, «Rifiuta tutto» e «Accetta tutto» hanno la stessa forma, la stessa dimensione e lo stesso colore; è disponibile anche uno stile «contorno». Lo stile che mette in evidenza «Accetta tutto» è proposto con un avviso, poiché la CNIL e l’EDPB valutano queste differenze caso per caso.

I colori (pulsanti, testo dei pulsanti, sfondo, testo) dispongono di palette pronte all’uso e di un controllo del contrasto in tempo reale, con una soglia di 4,5:1. L’anteprima mostra il vero banner, la finestra delle preferenze o il pulsante flottante, in larghezza computer o mobile, in ogni lingua, con le impostazioni non ancora salvate.

Aspetto del banner: disposizione, pulsanti, tema chiaro, scuro o automatico con controllo del contrasto, anteprima dal vivo
Aspetto del banner: disposizione, pulsanti, tema chiaro, scuro o automatico con controllo del contrasto, anteprima dal vivo

Tema e identità: tema chiaro, scuro o automatico (in base all’impostazione del dispositivo del visitatore) con i propri colori, icona cookie o logo del negozio, posizione del pulsante flottante, carattere di sistema o carattere del tema, e un campo CSS personalizzato aggiunto dopo il foglio di stile del banner.

Finestra delle preferenze in tema scuro, applicato automaticamente in base all’impostazione del dispositivo del visitatore
Finestra delle preferenze in tema scuro, applicato automaticamente in base all’impostazione del dispositivo del visitatore

Testi e lingue

I testi del banner sono forniti in francese, inglese, spagnolo, tedesco, italiano, polacco, olandese e portoghese. Il messaggio proposto per impostazione predefinita cita solo le finalità attivate nel tuo negozio, una riga per finalità, poi ricorda che rifiutare non impedisce né di navigare né di ordinare.

La scheda Testi permette di sostituire ogni testo lingua per lingua: titolo, messaggio, etichette dei pulsanti e indirizzi dell’informativa sulla privacy e della cookie policy. Un campo lasciato vuoto riprende il testo proposto. Nel messaggio, una riga che inizia con un trattino diventa un punto elenco. Anche una pagina CMS del negozio può fungere da informativa sulla privacy in tutte le lingue.

La frase «rifiutare non impedisce di ordinare» è esatta con il catalogo del modulo, in cui Stripe è strettamente necessario. Se sottoponi un metodo di pagamento al consenso, adatta il messaggio.

Testi del banner per lingua: titolo, messaggio ed etichette dei pulsanti, con anteprima dal vivo della finestra delle preferenze
Testi del banner per lingua: titolo, messaggio ed etichette dei pulsanti, con anteprima dal vivo della finestra delle preferenze

Comportamento

  • Durata di conservazione della scelta: 183 giorni per impostazione predefinita (6 mesi, durata che la CNIL presenta come una buona pratica), 365 giorni al massimo. Si applica sia al consenso sia al rifiuto.
  • Richiedi di nuovo il consenso a tutti: dopo una modifica importante, un pulsante fa ricomparire il banner per tutti i visitatori. Un servizio aggiunto viene comunque proposto ai visitatori che non l’hanno ancora visto.
  • Revoca del consenso: pulsante flottante, link «Gestisci i miei cookie» aggiunto automaticamente nel piè di pagina, qualsiasi link a #tarteaucitron, o chiamata JavaScript dftacOpenPreferences(). Quando un consenso viene revocato, i cookie del servizio vengono cancellati e la pagina viene ricaricata.
  • Account cliente: opzionale, la scelta di un cliente che ha effettuato l’accesso viene ritrovata sugli altri suoi dispositivi. È inclusa nell’esportazione e nell’eliminazione dei dati del modulo GDPR ufficiale di PrestaShop (psgdpr), se è installato.
  • X di chiusura: opzionale, equivale a «Rifiuta tutto».
  • Banner nascosto senza servizi soggetti a consenso: senza tracker da gestire, il banner non è necessario. Disattiva questa opzione se gestisci script al di fuori del modulo.
  • Global Privacy Control: opzionale, un browser che invia questo segnale viene trattato come un rifiuto.
Comportamento: durata di conservazione della scelta, revoca del consenso, visualizzazione, scelta memorizzata con l’account cliente
Comportamento: durata di conservazione della scelta, revoca del consenso, visualizzazione, scelta memorizzata con l’account cliente

Video e mappe incorporati: gli iframe riconosciuti (YouTube, Vimeo, Google Maps, Dailymotion, Spotify…) vengono sostituiti da un segnaposto «Consenti», accessibile da tastiera. La piattaforma viene contattata solo dopo il consenso del visitatore. Consentire un solo contenuto dal suo segnaposto non equivale a un consenso per il resto della categoria.

Video YouTube bloccato prima del consenso: segnaposto «Consenti YouTube» e link «Gestisci i miei cookie»
Video YouTube bloccato prima del consenso: segnaposto «Consenti YouTube» e link «Gestisci i miei cookie»

Cosa vede il visitatore

La prima schermata presenta il titolo, il messaggio, il link all’informativa sulla privacy e i pulsanti «Rifiuta tutto», «Accetta tutto» e «Personalizza». La finestra delle preferenze elenca le finalità con un interruttore ciascuna (disattivati per impostazione predefinita), i servizi di ogni categoria con i relativi cookie e la loro durata, e i cookie strettamente necessari, sempre attivi. Mostra anche l’identificativo del consenso, che il visitatore può comunicarti.

Finestra delle preferenze: scelta per finalità, servizi e cookie di ogni categoria con la relativa durata, link all’elenco dei cookie
Finestra delle preferenze: scelta per finalità, servizi e cookie di ogni categoria con la relativa durata, link all’elenco dei cookie

Su mobile, i pulsanti mantengono la stessa dimensione, ogni finalità sta su una riga e il banner non sposta la pagina.

Accessibilità: vere caselle di controllo annunciate come interruttori, finestra delle preferenze che mantiene il focus, chiusura con il tasto Esc con ritorno del focus, animazioni ridotte se il visitatore lo ha richiesto. Nessuna violazione è stata rilevata da axe-core (WCAG 2.1 A e AA) sul banner, sulle preferenze, su un contenuto bloccato e sull’elenco dei cookie, con tema chiaro e scuro.

Banner dei cookie su mobile: pulsanti «Rifiuta tutto» e «Accetta tutto» della stessa dimensione, link all’informativa sulla privacy
Banner dei cookie su mobile: pulsanti «Rifiuta tutto» e «Accetta tutto» della stessa dimensione, link all’informativa sulla privacy

Il modulo dichiara i valori predefiniti in cima alla pagina, prima di qualsiasi tag Google: pubblicità, misurazione e personalizzazione su denied, funzionamento e sicurezza su granted (modificabili). Non appena il visitatore sceglie, i segnali vengono aggiornati in base alle categorie accettate:

  • Misurazione dell’audience → analytics_storage;
  • Pubblicità → ad_storage, ad_user_data, ad_personalization;
  • Video, mappe e social network → personalization_storage.

Per un visitatore che ha già risposto, l’aggiornamento viene inviato in cima alla pagina dalla visualizzazione successiva, senza attendere il caricamento completo. Le opzioni wait_for_update, ads_data_redaction e url_passthrough sono configurabili, e un evento dftac_consent_update viene inviato al dataLayer per i tuoi trigger di Google Tag Manager.

Google Consent Mode v2: valori predefiniti negati, opzioni e corrispondenza con le categorie del banner
Google Consent Mode v2: valori predefiniti negati, opzioni e corrispondenza con le categorie del banner

Analisi degli script di terze parti

Il pulsante Analizza il mio negozio carica dal server la home page, una categoria, un prodotto, la pagina contatti e fino a 8 pagine a tua scelta, come un nuovo visitatore senza cookie. Il risultato elenca i tag bloccati automaticamente, gli script e i contenuti di terze parti ancora caricati prima della scelta (con un pulsante Blocca che crea la regola), i cookie installati dal server e i moduli installati noti per aggiungere i propri tag.

L’analisi si riavvia da sola all’apertura del back-office quando ha più di 30 giorni. Legge il codice HTML inviato dal negozio: uno script aggiunto in seguito tramite JavaScript non viene rilevato.

Analisi del negozio: tag bloccati automaticamente, script ancora caricati prima del consenso con pulsante «Blocca», moduli che aggiungono i propri tag
Analisi del negozio: tag bloccati automaticamente, script ancora caricati prima del consenso con pulsante «Blocca», moduli che aggiungono i propri tag

Statistiche e test A/B

La scheda Statistiche mostra le visualizzazioni, le scelte espresse, le quote di «Accetta tutto», «Rifiuta tutto» e di scelte personalizzate, il consenso per categoria, la ripartizione tra computer e mobile e l’andamento giornaliero, su 7, 30 o 90 giorni, 12 mesi o tutto lo storico, con esportazione CSV. I contatori sono aggregati per giorno, senza dati personali né cookie. Una visualizzazione viene conteggiata quando il banner viene visto da un visitatore che interagisce con la pagina; i bot sono esclusi.

Il test A/B confronta due formulazioni o layout. La variante viene estratta a ogni visualizzazione, senza salvare nulla presso il visitatore, ed entrambe le varianti mantengono «Rifiuta tutto» allo stesso livello di «Accetta tutto». Un vincitore viene annunciato solo oltre le 100 scelte per variante e con una differenza significativa al 95%.

Statistiche del banner: tassi di accettazione e rifiuto, ripartizione per dispositivo, andamento su 30 giorni
Statistiche del banner: tassi di accettazione e rifiuto, ripartizione per dispositivo, andamento su 30 giorni

Prova dei consensi

Ogni scelta viene registrata con la data, il suo identificativo casuale (conservato anche nel cookie del visitatore), l’azione, le categorie e i servizi accettati, la versione del banner presentata e l’origine della scelta (banner, preferenze, pulsante flottante, segnaposto di un contenuto bloccato). Non viene conservato alcun nome, e-mail o indirizzo IP in chiaro; un’impronta con salt dell’indirizzo IP è disponibile come opzione.

  • Ricerca per identificativo del consenso, esportazione CSV.
  • Ogni modifica dei testi, dei servizi o delle impostazioni presentati crea una versione del banner con data e ora, scaricabile in formato JSON.
  • Eliminazione automatica oltre la durata di conservazione scelta, senza attività pianificata; eliminazione manuale possibile.
  • Il registro viene conservato se il modulo viene disinstallato.
Prova dei consensi: registro con data e ora, ricerca per identificativo, esportazione CSV e versioni successive del banner
Prova dei consensi: registro con data e ora, ricerca per identificativo, esportazione CSV e versioni successive del banner

Hosting e peso

Prima di qualsiasi scelta, la pagina carica solo due file del modulo, serviti dal tuo negozio: lo script e il foglio di stile del banner. tarteaucitron.js, il suo file di lingua e i file dei servizi vengono scaricati solo dopo un consenso che li richiede; un visitatore che rifiuta non li scarica mai. L’opzione «CDN jsDelivr» carica in tal caso i file ufficiali da jsDelivr, una terza parte contattata non appena un servizio viene accettato.

Misurato su una home page PrestaShop 9.1.5 (tema Hummingbird): 2 file e 12 KB trasferiti prima di qualsiasi scelta. La versione 2.0.0 caricava 5 file e 38 KB (misurato su PrestaShop 8.2.1, tema Classic).

Multinegozio

Le impostazioni seguono il contesto di negozio scelto nel back-office: seleziona un negozio per configurarlo singolarmente. Il registro e le statistiche sono salvati per negozio.

Limiti da conoscere

  • Il modulo non è una piattaforma di consenso registrata presso IAB Europe (TCF) né una CMP certificata da Google. Se mostri pubblicità AdSense, Ad Manager o AdMob in Europa, Google richiede una CMP certificata.
  • Il blocco automatico e l’analisi leggono il codice HTML delle pagine: non vedono uno script iniettato in seguito da un altro script.
  • Il banner è lo stesso qualunque sia il paese del visitatore.
  • Queste funzioni aiutano ad applicare le buone pratiche della CNIL e dell’EDPB; non sostituiscono l’analisi giuridica del tuo sito (inventario dei tracker, informativa sulla privacy, contratti con i tuoi partner).

Risoluzione dei problemi

  • Il banner non viene mostrato: verifica che il banner sia attivato (interruttore in cima alla pagina), che almeno un servizio soggetto a consenso sia pronto, oppure disattiva l’opzione «Non mostrare il banner se nessun servizio è soggetto a consenso». Svuota poi la cache di PrestaShop.
  • Un servizio non si carica dopo l’accettazione: controlla il suo badge nella scheda Servizi. «Da completare» segnala un identificativo mancante o non valido.
  • Uno script si carica prima della scelta: avvia l’analisi, poi usa il pulsante «Blocca». Se lo script non compare, è probabilmente iniettato da un altro script: disattivalo nel modulo che lo aggiunge.
  • Uno strumento non funziona più dopo l’attivazione del blocco: aggiungi il suo indirizzo alle eccezioni della scheda Blocco, oppure dichiaralo come servizio affinché venga caricato dopo il consenso.
  • Il banner ricompare a ogni pagina: verifica il dominio del cookie e che il nome del cookie non sia stato modificato nel frattempo.
  • Nessuna voce nel registro: verifica che la registrazione sia attivata nella scheda Prova, poi fai una scelta in navigazione privata.

Hai bisogno di aiuto? Contatta il supporto DataFireFly dal tuo account cliente, risposta entro 24 ore lavorative.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza