Vuoi essere conforme all'IAB Transparency & Consent Framework per la pubblicità digitale? WPConsent è una Piattaforma di Gestione del Consenso (CMP) registrata presso l'IAB e include il supporto completo per TCF v2.3. Questa guida ti illustra come abilitare e configurare IAB TCF v2.3 in WPConsent.

Funzionalità Pro: questa funzionalità richiede WPConsent Pro.

Indice

• Prerequisiti
• Capire quando usare la modalità IAB TCF
• Abilitazione della modalità TCF
• Configurazione delle restrizioni globali dei fornitori
• Configurazione delle dichiarazioni dell'editore
• Selezione dei fornitori
• Salvataggio delle impostazioni TCF
• Test del banner frontend
• Revisione della finestra modale delle preferenze
• Come IAB TCF cambia WPConsent
• Verifica della configurazione
• Risoluzione dei problemi
• FAQ
• Conclusione

Prerequisiti

Prima di iniziare, assicurati di avere:

• WPConsent Pro installato e attivato
• Una comprensione di base dei concetti IAB TCF (scopi, fornitori, interesse legittimo)
• Un elenco dei fornitori registrati IAB con cui lavori
• Familiarità con i requisiti della policy IAB TCF v2.3

Capire quando usare la modalità IAB TCF

Vorrai abilitare IAB TCF v2.3 se:

• Lavori con fornitori pubblicitari registrati IAB (Google AdSense, Criteo, ecc.)
• Servi pubblico nell'UE/SEE che richiede la conformità GDPR
• Hai bisogno di generare stringhe TC conformi all'IAB per la pubblicità programmatica
• Vuoi usare l'interfaccia standardizzata __tcfapi()

Non hai bisogno della modalità TCF se utilizzi solo fornitori non-IAB o strumenti di analisi generali. Le categorie di cookie standard di WPConsent funzionano meglio per configurazioni più semplici. Per l'approccio non-TCF, consulta la gestione delle categorie di cookie.

Abilitazione della modalità TCF

Innanzitutto, naviga su WPConsent >> Impostazioni nella tua bacheca di WordPress. Quindi fai clic sulla scheda IAB TCF nella parte superiore della pagina.

Nella metabox Attivazione TCF, imposta l'interruttore Abilita TCF sulla posizione ON. Una nota sotto l'interruttore spiega che questa impostazione forza determinati comportamenti del banner.

Importante: L'abilitazione della modalità TCF forza comportamenti specifici del banner per garantire la conformità:

• Il layout del banner cambia in stile modale (sovrapposizione a schermo intero). I layout a barra e ad angolo non sono disponibili.
• I testi dei pulsanti cambiano in etichette richieste dall'IAB: "Accetta tutto", "Rifiuta tutto", "Gestisci impostazioni" e "Salva impostazioni".
• Il messaggio del banner viene sostituito con una versione conforme all'IAB. Include scopi di elaborazione dati, conteggio dei fornitori e divulgazione dell'interesse legittimo.
• Il pulsante mobile "Preferenze cookie" è abilitato automaticamente per il ripresentarsi del consenso.
• Le categorie standard dei cookie (Essenziali, Marketing, Statistiche, ecc.) vengono mantenute come “Categorie Non IAB TCF” e visualizzate separatamente dagli scopi IAB.
• Gli scopi IAB diventano il meccanismo di consenso primario. Non è possibile modificarli o eliminarli.
• L'interruttore manuale per i singoli servizi è impostato su ATTIVO.

Queste modifiche sono richieste dalla policy IAB TCF v2.3. Vengono ripristinate alle impostazioni originali quando si disabilita la modalità TCF.

Configurazione delle restrizioni globali dei fornitori

Il metadimensionale Restrizioni Globali dei Fornitori consente di applicare restrizioni a livello di editore a tutti i fornitori contemporaneamente.

L'impostazione chiave è Interesse Legittimo:

• Consenti Interesse Legittimo (Predefinito): I fornitori possono utilizzare l'interesse legittimo come base giuridica per determinati scopi.
• Disabilita Interesse Legittimo per Tutti gli Scopi: Forza tutti gli scopi a richiedere il consenso esplicito dell'utente. La colonna dell'interesse legittimo viene nascosta nella scheda dei fornitori nella finestra modale delle preferenze.
• Disabilita Interesse Legittimo per Scopi Specifici: Consente di scegliere singoli scopi che richiedono il consenso invece dell'interesse legittimo.

La maggior parte degli editori lascia questa impostazione predefinita, a meno che il consulente legale non indichi diversamente. Disabilitare l'interesse legittimo a livello globale è un approccio più restrittivo che alcuni siti focalizzati sulla privacy preferiscono.

Configurazione delle dichiarazioni dell'editore

Il metadimensionale Dichiarazioni dell'Editore consente di dichiarare per quali scopi (l'editore) elabora i dati direttamente, separatamente dai propri fornitori.

Per ogni scopo, è possibile dichiarare:

• Consenso: Elabori i dati per questo scopo e richiedi il consenso dell'utente.
• Trasparenza Interesse Legittimo: Elabori i dati per questo scopo in base all'interesse legittimo.

Queste dichiarazioni popolano la sezione publisher della stringa TC. Lascia invariate queste impostazioni a meno che tu non elabori direttamente i dati dell'utente per scopi specifici oltre a quelli gestiti dai tuoi fornitori.

Selezione dei fornitori

Scorri verso il basso fino alla sezione dell'elenco dei fornitori. Vedrai un elenco ricercabile e ordinabile di tutti i fornitori registrati IAB dall'elenco globale dei fornitori.

Per gestire i fornitori:

1. Utilizza la barra di ricerca per trovare fornitori specifici per nome o ID fornitore.
2. Utilizza il filtro di stato per mostrare tutti i fornitori, solo quelli selezionati o solo quelli non selezionati.
3. Utilizza il menu a discesa di ordinamento per organizzare per nome o ID fornitore in ordine crescente o decrescente.
4. Seleziona o deseleziona la casella accanto a ciascun fornitore. Puoi anche fare clic in qualsiasi punto dell'intestazione della riga del fornitore per attivare/disattivare la selezione.
5. Fai clic sul pulsante freccia su una riga del fornitore per espandere i relativi dettagli. Questo mostra gli scopi, gli scopi di interesse legittimo, gli scopi speciali e i link alle policy.

Per impostazione predefinita, tutti i fornitori sono selezionati la prima volta che visiti questa pagina. Dovrai deselezionare i fornitori che non utilizzi per ridurre la lunghezza del tuo prompt di consenso e migliorare la trasparenza per i tuoi visitatori.

Ogni voce del fornitore mostra:

• Nome e ID fornitore: Il nome registrato IAB e l'identificatore numerico.
• Link all'Informativa sulla Privacy: Apre l'informativa sulla privacy del fornitore in una nuova scheda.
• Link alla rivendicazione di interesse legittimo: Apre la rivendicazione di interesse legittimo del fornitore (se disponibile).
• Restrizioni per fornitore: Espandi i dettagli del fornitore per configurare restrizioni sugli scopi per fornitore e richiedere il consenso per specifici scopi di interesse legittimo.

Salvataggio delle impostazioni TCF

Per applicare le modifiche, fai clic su Salva modifiche in fondo alla pagina IAB TCF. Il plugin salva i fornitori selezionati, le restrizioni dell'editore, le dichiarazioni dell'editore e lo stato di abilitazione TCF. Cancella anche la cache dei cookie delle preferenze in modo che il frontend rifletta immediatamente le tue modifiche.

Test del banner frontend

Apri il tuo sito web in una finestra del browser anonima o privata. Vedrai un banner modale conforme al TCF.

Il banner modale include:

• Un messaggio standardizzato che descrive l'elaborazione dei dati e le partnership con i fornitori, mostrando il numero effettivo di fornitori selezionati.
• Una sezione Scopi di elaborazione dati che elenca ogni scopo IAB con il conteggio dei fornitori (ad es. "3 richiedono il consenso, 2 utilizzano l'interesse legittimo").
• Una sezione Funzionalità speciali se uno qualsiasi dei fornitori selezionati utilizza funzionalità speciali come la geolocalizzazione precisa.
• Un avviso di interesse legittimo (se i fornitori selezionati utilizzano l'interesse legittimo).
• Informazioni sull'ambito del consenso e sul ritiro.
• Un link Visualizza elenco fornitori che apre direttamente la finestra modale delle preferenze nella scheda fornitori.
• 3 pulsanti: Accetta tutto, Rifiuta tutto e Gestisci impostazioni.

Revisione della finestra modale delle preferenze

Fai clic su Gestisci impostazioni per aprire la finestra modale delle preferenze. Contiene 3 schede:

Scheda Scopi:

• Sezione Categorie non IAB TCF (Essenziali, Marketing, Statistiche, ecc.) con i relativi interruttori standard.
• Sezione Scopi IAB TCF con ogni scopo che mostra la sua descrizione, illustrazioni, conteggio dei fornitori e un link "Visualizza elenco fornitori".
• Sezione Scopi speciali che mostra le attività di elaborazione che non richiedono il consenso (sicurezza, prevenzione frodi, consegna tecnica).
• Una dichiarazione di archiviazione della stringa TC che spiega che le scelte di consenso vengono salvate in localStorage e in un cookie per un massimo di 12 mesi.

Scheda Funzionalità:

• Sezione Funzionalità che elenca le capacità tecniche che i fornitori utilizzano per supportare l'elaborazione dei dati. Queste non richiedono un consenso separato.
• Sezione Funzionalità speciali con interruttori per le funzionalità che richiedono il consenso esplicito, come "Utilizza dati di geolocalizzazione precisi" e "Scansiona attivamente le caratteristiche del dispositivo per l'identificazione".

Scheda Fornitori:

• Una barra di ricerca con un pulsante di filtro. Il menu a discesa del filtro consente di restringere i fornitori per scopo, scopo speciale o funzionalità speciale.
• Interruttori principali per Consenso e Interesse legittimo nella parte superiore dell'elenco.
• Ogni riga del fornitore mostra il nome del fornitore con gli interruttori di consenso e interesse legittimo.
• L'espansione di un fornitore mostra informazioni dettagliate: scopi, scopi di interesse legittimo, scopi speciali, funzionalità, categorie di dati, periodi di conservazione dei dati, durata di archiviazione dei cookie, link all'informativa sulla privacy e link alla dichiarazione di interesse legittimo.
• I chip del filtro attivo mostrano i criteri di filtro attualmente selezionati.

Un pulsante Rifiuta tutto appare accanto a Salva impostazioni nel piè di pagina della finestra modale delle preferenze per la conformità TCF.

Come IAB TCF cambia WPConsent

Quando la modalità TCF è abilitata, diversi comportamenti principali cambiano. Comprendere queste modifiche ti aiuta a risolvere i problemi e a definire le aspettative.

Categorie di cookie sostituite da scopi

Le categorie di cookie standard (Marketing, Statistiche, ecc.) sono conservate come “Categorie Non-IAB TCF” e visualizzate in una sezione separata. Gli scopi IAB diventano il meccanismo di consenso primario. I pulsanti di modifica ed eliminazione sono nascosti sia per le categorie di scopi IAB che per la categoria Essenziale. Per sapere come funzionano le categorie in modalità non-TCF, vedi gestione delle categorie di cookie.

Layout del banner forzato in modale

Il layout del banner è forzato nello stile modale indipendentemente dalle tue impostazioni del layout del banner. I layout a barra e ad angolo non sono permessi secondo la policy IAB TCF v2.3 perché il prompt di consenso deve essere prominente e inequivocabile.

Testi e messaggi dei pulsanti applicati

Le etichette dei pulsanti e i messaggi del banner sono sovrascritti con testo conforme a IAB. Le tue etichette personalizzate dei pulsanti e il messaggio del banner vengono ripristinati quando disabiliti la modalità TCF. I testi applicati sono:

Elemento	Testo applicato
Pulsante Accetta	Accetta Tutto
Pulsante Rifiuta	Rifiuta Tutto
Pulsante Preferenze	Gestisci Impostazioni
Pulsante Salva preferenze	Salva Impostazioni

Pulsante flottante sempre attivo

Il pulsante flottante “Preferenze cookie” è forzato su ON quando TCF è attivo. La policy IAB TCF C(f) richiede una facile riapparizione dell'interfaccia utente del consenso in modo che gli utenti possano rivedere e modificare le proprie preferenze in qualsiasi momento.

Struttura dati del consenso

WPConsent salva 2 record di consenso quando TCF è attivo:

• Preferenze standard WPConsent: Archiviate nel cookie wpconsent_preferences (per categorie non-TCF come Essenziale, Marketing, Statistiche).
• TC String: Archiviata sia nel cookie wpconsent_tcstring che in localStorage (per fornitori e scopi IAB). La TC String codifica tutte le scelte di consenso e interesse legittimo in un formato standardizzato che i fornitori IAB possono leggere.

Integrazione API CMP

La funzione __tcfapi() diventa disponibile globalmente sul tuo sito web. Una versione stub viene caricata presto nella sezione di ogni pagina in modo che sia disponibile prima che vengano eseguiti eventuali script dei fornitori. L'API CMP completa si inizializza dopo il caricamento del banner.

Gli script di terze parti utilizzano __tcfapi() per:

• Interrogare lo stato del consenso per scopi e fornitori specifici.
• Ascoltare le modifiche del consenso tramite callback di eventi.
• Recuperare la TC String codificata.

WPConsent è registrato con CMP ID 482. L'API CMP utilizza la versione 2 della specifica IAB TCF.

Esempio: Verifica dello stato del consenso da JavaScript:

__tcfapi('getTCData', 2, function(tcData, success) {
    if (success) {
        console.log('TC String:', tcData.tcString);
        console.log('Purpose 1 consent:', tcData.purpose.consents[1]);
        console.log('Vendor 755 consent:', tcData.vendor.consents[755]);
    }
});

Gestione dell'interesse legittimo

Alcuni scopi IAB supportano l'interesse legittimo come base giuridica. Questi sono scopi per i quali i fornitori possono elaborare i dati senza consenso esplicito, a meno che l'utente non si opponga. Nella modale delle preferenze:

• La scheda Scopi mostra il conteggio dei fornitori sia per "richiesta di consenso" che per "utilizzo dell'interesse legittimo" per ogni scopo.
• La scheda Fornitori mostra interruttori separati per Consenso e Interesse Legittimo per ciascun fornitore.
• Gli interruttori per l'interesse legittimo sono attivati per impostazione predefinita (selezionati). I fornitori elaborano i dati in base all'interesse legittimo a meno che l'utente non si opponga attivamente.
• Gli interruttori principali in cima all'elenco dei fornitori consentono agli utenti di accettare o rifiutare tutte le scelte di consenso o di interesse legittimo contemporaneamente.

Puoi limitare l'interesse legittimo a livello globale o per fornitore utilizzando le Restrizioni globali dei fornitori e le impostazioni individuali di restrizione del fornitore nel pannello di amministrazione.

Caricamento e memorizzazione nella cache della GVL

Il plugin scarica la Global Vendor List (GVL) dal server IAB Europe all'indirizzo https://vendor-list.consensu.org/v3/vendor-list.json. La GVL contiene tutti i fornitori registrati, i loro scopi, funzionalità e dettagli sull'elaborazione dei dati.

La GVL viene memorizzata nella cache localmente nella directory /wp-content/uploads/wpconsent/cache/. La durata della cache segue le intestazioni di cache HTTP dal server IAB (tipicamente 24 ore). Se il server non è disponibile, WPConsent utilizza la versione memorizzata nella cache in precedenza come fallback. Se non esiste una versione memorizzata nella cache, l'elenco dei fornitori mostra uno stato di errore e riprova dopo 1 ora.

Sul frontend, l'URL di base della GVL punta alla cache locale in modo che i dati del fornitore vengano caricati dal tuo server. Il JavaScript frontend utilizza la classe GVL della libreria @iabtechlabtcf/core per analizzare i dati del fornitore e limitarli solo ai fornitori selezionati.

Restrizioni dell'editore nella stringa TC

Le restrizioni dell'editore sono codificate direttamente nella stringa TC utilizzando la classe PurposeRestriction da @iabtechlabtcf/core. Sono supportati 2 tipi di restrizione:

• NON_PERMESSO (0): Lo scopo non è consentito per un fornitore specifico. Il fornitore non può elaborare dati per questo scopo indipendentemente dal consenso dell'utente.
• RICHIESTO_CONSENSO (1): Lo scopo richiede il consenso esplicito invece dell'interesse legittimo. Il fornitore non può fare affidamento sull'interesse legittimo per questo scopo.

Queste restrizioni comunicano le tue politiche di elaborazione dei dati ai fornitori quando decodificano la stringa TC.

Verifica della configurazione

Dopo aver abilitato IAB TCF v2.3, conferma che funzioni correttamente.

Verifica della generazione della stringa TC

1. Apri la console per sviluppatori del tuo browser (F12).
2. Digita __tcfapi('getTCData', 2, console.log) e premi Invio.
3. Cerca tcString nell'output registrato.
4. La stringa contiene dati di consenso codificati.
5. Verifica che cmpId sia 482 nell'output.

Verifica della disponibilità dell'API CMP

La funzione __tcfapi() è disponibile immediatamente al caricamento della pagina, prima che vengano eseguiti altri script. Per verificarlo, controlla typeof __tcfapi nella console. Restituisce "function".

Controllo dell'archiviazione del consenso

1. Apri DevTools e vai alla scheda Applicazione.
2. Cerca wpconsent_tcstring sia in Archiviazione locale che nei Cookie.
3. Dopo aver accettato o rifiutato il consenso, la TC String si aggiorna in entrambe le posizioni.

Validazione con il validatore IAB

Utilizza lo Strumento di validazione TCF IAB per verificare la conformità:

1. Visita il sito web del validatore.
2. Inserisci l'URL del tuo sito.
3. Rivedi il report di validazione per eventuali violazioni delle norme.

Risoluzione dei problemi

Scopi non visualizzati

Sintomo: La pagina Impostazioni non mostra scopi IAB dopo aver abilitato la modalità TCF.

Soluzione: L'elenco globale dei fornitori (GVL) non è stato ancora caricato. Verifica che:

• Il tuo server sia in grado di effettuare richieste HTTPS in uscita a vendor-list.consensu.org.
• La directory /wp-content/uploads/wpconsent/cache/ sia scrivibile dal tuo server web.
• Prova ad aggiornare la pagina IAB TCF per attivare un nuovo download GVL.

TC string non salvata

Sintomo: Gli utenti vedono il banner ad ogni visita alla pagina nonostante abbiano dato il consenso.

Soluzione: Controlla l'archiviazione del browser:

• Apri DevTools, vai su Applicazione, quindi Archiviazione locale e cerca una voce wpconsent_tcstring.
• Controlla DevTools, quindi Applicazione, quindi Cookie per un cookie wpconsent_tcstring.
• Se mancante, verifica che i cookie e localStorage non siano bloccati dalle impostazioni del browser, dai blocchi pubblicitari o dalle estensioni per la privacy.

Script dei fornitori non caricati dopo il consenso

Sintomo: I fornitori IAB non vengono caricati dopo che il consenso è stato concesso.

Soluzione: La modalità IAB TCF genera la TC String ed espone l'interfaccia __tcfapi(), ma non carica automaticamente gli script o i tag dei fornitori. È necessario integrare gli script dei fornitori separatamente utilizzando la loro documentazione. Gli script dei fornitori in genere chiamano __tcfapi('addEventListener', 2, callback) per ascoltare le modifiche al consenso e attivarsi in base alla TC String.

Conflitti di stile del banner

Sintomo: Il banner modale non viene visualizzato correttamente o sovrappone il contenuto.

Soluzione: La modalità TCF impone un layout modale per la conformità alle norme. In caso di conflitti CSS:

• Il banner WPConsent viene renderizzato all'interno di uno Shadow DOM, che isola i suoi stili dal tuo tema e da altri plugin per progettazione. Le regole CSS esterne che puntano a .wpconsent-banner non possono raggiungere gli elementi all'interno dello Shadow DOM. Per personalizzare gli stili del banner, utilizza le impostazioni di stile del banner in WPConsent o aggiungi variabili CSS che lo Shadow DOM eredita.
• Verifica che nessun JavaScript interferisca con la visualizzazione del modale.
• Il layout del popup TCF non può essere modificato in stile barra o angolo mentre TCF è attivo.

Le schede del popup delle preferenze non vengono caricate

Sintomo: La scheda Funzionalità o Fornitori nel popup delle preferenze mostra contenuti vuoti.

Soluzione: Queste schede si popolano dinamicamente utilizzando i dati GVL caricati tramite JavaScript. Verifica che:

• Lo script iab-tcf.js si carichi correttamente (controlla la scheda Rete in DevTools per eventuali errori).
• Il file di cache GVL sia accessibile all'indirizzo /wp-content/uploads/wpconsent/cache/vendor-list.json.
• Non ci siano errori JavaScript nella console relativi al caricamento del GVL.

FAQ

Ho bisogno di IAB TCF se uso solo Google Analytics?

No. Se utilizzi solo fornitori non IAB o strumenti di analisi generali, le categorie di cookie standard di WPConsent sono più adatte. La modalità TCF è progettata per gli editori che lavorano con fornitori pubblicitari registrati IAB.

Le impostazioni personalizzate del mio banner verranno perse quando abiliterò TCF?

No. Le etichette dei pulsanti personalizzati, il messaggio del banner e le impostazioni di layout vengono conservati. La modalità TCF li sovrascrive temporaneamente mentre è attiva. Quando disattivi la modalità TCF, le tue impostazioni originali vengono ripristinate.

Posso cambiare il layout del banner mentre TCF è attivo?

No. La policy IAB TCF v2.3 richiede che il banner venga visualizzato come un overlay popup a schermo intero. I layout a barra e ad angolo non sono consentiti. Il layout tornerà alle tue impostazioni preferite quando disattiverai TCF.

Perché tutti i fornitori sono selezionati per impostazione predefinita?

Tutti i fornitori vengono selezionati la prima volta che visiti la pagina IAB TCF per assicurarti che nulla venga perso. Si consiglia di deselezionare i fornitori che non si utilizzano per accorciare il prompt del consenso e migliorare la trasparenza.

Qual è l'ID CMP per WPConsent?

WPConsent è registrato con l'ID CMP 482 nel sistema IAB TCF.

Conclusione

Ora hai configurato il supporto per IAB TCF v2.3 in WPConsent. Il tuo sito genera stringhe TC conformi e fornisce ai visitatori controlli granulari del consenso per i fornitori registrati IAB. Ricorda di verificare la tua configurazione utilizzando lo strumento IAB TCF Validator e di rivedere periodicamente la selezione dei fornitori in base alle modifiche delle tue partnership pubblicitarie.

Per saperne di più sulle opzioni di visualizzazione del banner che si applicano al di fuori della modalità TCF, consulta le opzioni di layout del banner.