Configurazione delle Impostazioni di Consenso GDPR in Pixel Plus per PrestaShop

Introduzione

Il modulo Pixel Plus per PrestaShop ti aiuta a conformarti alle normative GDPR bloccando gli eventi del Facebook Pixel e dell'API di Conversione (CAPI) fino a quando il cliente non dà il consenso esplicito.

Questa guida ti mostrerà come:

• Rilevare dove il tuo gestore di consenso salva i dati di consenso (Cookies, Local Storage o cookie interno di PrestaShop).
• Configurare Pixel Plus per bloccare o consentire gli eventi di conseguenza.
• Testare e verificare che gli eventi siano bloccati e sbloccati correttamente in base al consenso.

---

Passaggio 1: Identificare Dove sono Archiviati i Dati di Consenso

I dati di consenso sono generalmente archiviati in:

1. Cookies (più comune)
2. Local Storage (meno comune)
3. Cookie interno di PrestaShop

Durante l'ispezione, accetta solo i cookie di marketing/personalizzazione pubblicitaria nel tuo popup di consenso. Questo assicura che tu stia verificando i cookie rilevanti per l'uso del Facebook Pixel.

---

Opzione A: Verificare i Cookies (Più Comune)

1. Apri il tuo negozio in Google Chrome.
2. Premi F12 o fai clic destro → Ispeziona per aprire DevTools.
3. Vai alla scheda Application.
4. Espandi Cookies e seleziona il dominio del tuo negozio.
5. Accetta solo i cookie di marketing.
6. Cerca:
   • Nuovi cookie aggiunti dopo l'accettazione.
   • Modifiche nei valori dei cookie esistenti.

Esempi Comuni di Cookie:

Nome del Cookie	Valore di Esempio
cookieconsent_status	accepted
cookiebot_consent	{"marketing":"true","statistics":"false"}
oneplus_consent	{"ads":"true","necessary":"true"}

Prendi nota di:

• Il nome del cookie, ad es., cookiebot_consent.
• La coppia di valori, come "marketing":"true".

---

Opzione B: Verificare il Local Storage (Se i Cookie non Mostrano Nulla)

1. In DevTools, vai in Application → Local Storage.
2. Seleziona il dominio del tuo negozio.
3. Accetta solo i cookie di marketing e cerca nuove voci.

Esempio:

Chiave	Valore
cookieplusConsent	{"marketing":"true","preferences":"false"}

Prendi nota di:

• Il nome della chiave.
• Il valore specifico come "marketing":"true".

---

Opzione C: Verificare il Cookie Interno di PrestaShop (Se Nessun Risultato)

Se non appaiono cookie rilevanti o voci di local storage:

1. In Back Office PrestaShop → Moduli → Pixel Plus → Sezione GDPR, trova:

   "Se stai usando un modulo che genera il cookie e non conosci il nome e il valore del cookie, puoi cliccare qui per generare un token temporale per accedere ai cookie del front."

2. Fai clic su "Fai clic qui".

3. Apparirà un nuovo pulsante, fai clic su di esso per Stampare i cookie del front, non hashati.

4. Verrà visualizzato un elenco chiaro di cookie (inclusi quelli interni) in formato tabella.

5. Fai clic una volta sul nome del cookie correlato al consenso.

6. Verrà ora visualizzato un elenco delle coppie chiave > Valore

7. Fai clic ora su quello correlato al marketing / annunci

Pixel Plus compilerà automaticamente il nome e il valore del cookie.

---

Passaggio 2: Abilitare il Blocco GDPR in Pixel Plus

1. In Back Office PrestaShop → Moduli → Pixel Plus → Sezione GDPR, abilita:

Blocca lo script: Abilitato

Questo ferma gli eventi Pixel e CAPI fino alla conferma del consenso.

---

Passaggio 3: Configurare la Modalità di Blocco GDPR

Scegli in base a ciò che hai trovato:

Opzione	Da Usare Quando
Cookies	Il consenso è salvato in un cookie del browser.
Local Storage	Il consenso è salvato nel local storage.
Cookie Interno	Il consenso si trova nel cookie interno di PrestaShop.

---

Passaggio 4: Inserire i Dettagli del Cookie o del Local Storage

A) Usando i Cookies:

• Aggiungi il nome del cookie da cercare che avrai trovato in precedenza:
  Esempio: cookiebot_consent, cookieconsent_status, oneplus_consent

• Valore Specifico del Cookie (opzionale):
  Esempio: "marketing":"true"
  Se più valori:
  marketing:true|||ads:true

• È un Cookie Esterno:
  Imposta su External se generato da un servizio esterno (es., Cookiebot).
  Imposta su PrestaShop se è un cookie interno.

---

B) Usando il Local Storage:

• Inserisci il nome della chiave, ad es., cookieplusConsent.
• Inserisci la coppia di valori se applicabile, ad es., "marketing":"true".
• Imposta È un Cookie Esterno = External.

---

C) Usando il Cookie Interno:

Se hai usato lo strumento Stampare i cookie del front, Pixel Plus compilerà automaticamente:

• Il nome del cookie.
• La coppia di valori specifica.

Imposta È un Cookie Esterno = PrestaShop.

---

Passaggio 5: Gestire i Ricaricamenti di Pagina Dopo il Consenso

Scenario	Impostazione
La pagina si ricarica dopo l'accettazione/rifiuto del consenso	Abilita La pagina si ricarica dopo il consenso?
La pagina NON si ricarica	Configura Selettore per il Pulsante dei Cookie

---

Passaggio 6: Configurare il Selettore del Pulsante dei Cookie (Per Pagine senza Ricaricamento)

1. Apri Chrome DevTools → scheda Elements.
2. Usa lo strumento Select Element per fare clic sul pulsante del banner dei cookie.
3. Verifica se è un elemento <button> o <a>.
4. Ispeziona i contenitori padre per trovare un wrapper.
5. Costruisci un selettore:

.cookie-banner-wrapper button

6. Inserisci questo in Selettore per il Pulsante dei Cookie.

---

Passaggio 7: Disabilitare la Validazione Avanzata del Consenso (Opzionale)

Se:

• Il consenso è configurato correttamente.
• Gli eventi non si attivano dopo l'accettazione.

Abilita:

Disabilita la validazione avanzata del consenso: Abilitato

---

Passaggio 8: Testare la Configurazione GDPR

1. Cancella cookie e local storage nel tuo browser.
2. Apri il tuo negozio.
3. Apri Pixel Helper o lo strumento Facebook Test Events.
4. Ricarica la pagina:
   • Inizialmente non dovrebbero attivarsi eventi.
5. Accetta solo i cookie di marketing.
6. Verifica che:
   • Gli eventi Pixel (come PageView) inizino ad attivarsi.
   • Gli eventi CAPI vengano registrati correttamente se configurati.

---

Conclusione

Seguendo questi passaggi, hai:

• Identificato se il consenso è archiviato in Cookies, Local Storage o cookie interni di PrestaShop.
• Configurato Pixel Plus per bloccare gli eventi Facebook Pixel e CAPI in base al consenso.
• Garantito la conformità GDPR mantenendo un tracciamento accurato degli eventi.
• Verificato il comportamento corretto utilizzando gli strumenti di debug di Facebook.

Per ulteriori informazioni, consulta le Linee Guida sul Consenso di Facebook.

---

Risoluzione dei Problemi

Problema	Soluzione
Gli eventi si attivano anche prima del consenso	Assicurati che Blocca lo script sia impostato su Abilitato e che il nome del cookie sia corretto (sensibile alle maiuscole/minuscole)
Gli eventi non si attivano mai dopo il consenso	Verifica che il valore del cookie corrisponda esattamente. Prova a lasciare il valore vuoto per testare. Controlla l'impostazione Esterno vs PrestaShop.
Gli eventi si attivano al caricamento della pagina ma non durante la navigazione	Il tuo gestore di consenso potrebbe non ricaricare la pagina. Configura il selettore del pulsante o abilita l'opzione di ricaricamento.
Gli eventi CAPI mancano ma il Pixel funziona	Anche CAPI rispetta il consenso. Verifica che gli eventi lato server appaiano in Test Events dopo aver concesso il consenso.
Eventi di Acquisto duplicati	Abilita "Impedisci il tracciamento degli acquisti duplicati" — questo imposta un cookie di 24 ore per bloccare il reinvio se la pagina di conferma dell'ordine viene rivisitata.

---

Riferimento

Cosa Viene Bloccato

Quando il blocco è attivo e il consenso non è stato concesso:

• Facebook Pixel: viene inizializzato ma impostato su fbq('consent', 'revoke') — Meta non riceve dati di tracciamento.
• API di Conversione: gli eventi lato server non vengono inviati a Facebook.
• Cookie di tracciamento: 13 cookie temporanei (_fbp, ID degli eventi, ecc.) vengono eliminati automaticamente.

Quando il consenso è stato concesso:

• Il Pixel passa a fbq('consent', 'grant') — il tracciamento normale riprende.
• Gli eventi CAPI si attivano per il tracciamento lato server.
• I cookie di tracciamento vengono ricreati al successivo caricamento della pagina.

Gestori di Consenso Supportati

Pixel Plus funziona con qualsiasi gestore di consenso che memorizzi il consenso nei cookie o nel localStorage. Testato con:

• Cookiebot
• Iubenda
• Osano
• CookiePlus
• TrustArc
• OnePlus Cookie Module
• LGCookiesLaw (ha un'integrazione dedicata — rilevato automaticamente quando il nome del cookie è lgcookieslaw)
• Modulo GDPR nativo di PrestaShop
• Qualsiasi soluzione personalizzata

Override JavaScript

Per gli sviluppatori: puoi forzare il blocco del pixel da qualsiasi script impostando:

window.doNotConsentToPixel = true;

Questo blocca il tracciamento indipendentemente da qualsiasi altra configurazione. Utile per flussi di consenso personalizzati o per i test.

Deduplicazione degli Acquisti

L'opzione "Impedisci il tracciamento degli acquisti duplicati" (FCTP_COOKIE_CONTROL) imposta un cookie del browser (pp_purchaseSent) con l'ID dell'ordine dopo che si attiva un evento di Acquisto. Se il cliente rivisita la pagina di conferma dell'ordine entro 24 ore, l'evento non viene inviato nuovamente. Questo vale sia per il Pixel che per la CAPI.

Riferimento delle Chiavi di Configurazione

Per sviluppatori e utenti avanzati:

Chiave	Tipo	Predefinito	Descrizione
FCTP_BLOCK_SCRIPT	int	0	Interruttore principale: abilitare/disabilitare il blocco del consenso
FCTP_BLOCK_SCRIPT_MODE	string	cookies	Modalità di rilevamento: cookies o local_storage
FCTP_COOKIE_NAME	string	(vuoto)	Nome del cookie da controllare
FCTP_COOKIE_VALUE	string	(vuoto)	Valore/i da far corrispondere — usa ||| per separarne più di uno
FCTP_COOKIE_EXTERNAL	int	0	0 = sessione PrestaShop, 1 = cookie HTTP
FCTP_COOKIE_RELOAD	int	1	1 = la pagina si ricarica dopo il consenso
FCTP_COOKIE_BUTTON	string	(vuoto)	Selettore CSS per il pulsante di accettazione (modalità senza ricaricamento)
FCTP_LOCAL_STORAGE_VAR_PATH	string	(vuoto)	Percorso localStorage (usa >> per l'annidamento)
FCTP_LOCAL_STORAGE_VALUE	string	(vuoto)	Valore localStorage atteso per il consenso
FCTP_COOKIE_CONTROL	int	0	Abilitare la deduplicazione degli acquisti

Come Funziona il Rilevamento del Consenso (Tecnico)

1. PixelTools::getConsent() controlla prima la cache di sessione (cookie pp_consent).
2. Senza cache: blocco disabilitato → consenso concesso. Blocco abilitato → controlla il cookie o il localStorage.
3. Modalità cookie: legge da $_COOKIE (esterno) o dalla sessione PrestaShop (interno). Divide il valore per ||| e corrisponde a qualsiasi elemento.
4. Modalità localStorage: JavaScript controlla il percorso dopo un ritardo di 1,5 secondi, poi invia una richiesta AJAX per confermare.
5. Il risultato viene memorizzato nella cache di sessione per il resto della visita.
6. Sia il Pixel (lato client) che la CAPI (lato server) verificano indipendentemente il consenso prima di inviare eventi.

Quali gestori di consenso sono compatibili con Pixel Plus per il GDPR?

Pixel Plus funziona con qualsiasi gestore di consenso che memorizzi il consenso nei cookie o nel localStorage. Tra quelli testati: Cookiebot, Iubenda, Osano, CookiePlus, TrustArc, OnePlus Cookie Module, LGCookiesLaw e il modulo GDPR nativo di PrestaShop.

Come blocca Pixel Plus gli eventi Pixel prima del consenso?

Quando il blocco del consenso è attivo, il Facebook Pixel viene inizializzato ma con fbq consent revoke, il che fa sì che Meta non riceva dati di tracciamento. Anche gli eventi dell'API di Conversione lato server non vengono inviati. I cookie di tracciamento temporanei vengono anche eliminati automaticamente.

Dove sono archiviati i dati di consenso e come rilevarli?

I dati di consenso possono essere archiviati nei cookie HTTP, nel Local Storage del browser o nel cookie di sessione interno di PrestaShop. Per rilevarlo, usa i DevTools di Chrome, accetta solo i cookie di marketing e osserva quale cookie o valore cambia sotto Application, poi Cookies o Application, poi Local Storage.

Anche gli eventi dell'API di Conversione rispettano il consenso GDPR?

Sì. Sia il Pixel che l'API di Conversione verificano indipendentemente il consenso prima di inviare eventi. Se il consenso non è stato concesso, anche gli eventi lato server non vengono inviati a Facebook.

Cosa fare se gli eventi si attivano prima del consenso?

Se gli eventi si attivano prima del consenso, verifica che l'opzione Blocca lo script sia abilitata e che il nome del cookie sia corretto (sensibile alle maiuscole/minuscole). Controlla anche che il valore del cookie corrisponda esattamente a ciò che imposta il tuo gestore di consenso.