- Versione 2.1 del TCF: continueremo ad accettare le stringhe nella versione 2.1 del TCF, ma invitiamo le CMP a seguire le linee guida di IAB sugli obiettivi di implementazione durante il passaggio alla versione 2.2 del TCF.
- Soluzioni di gestione del consenso di Google: le soluzioni di gestione del consenso di Google, disponibili nella scheda Privacy e messaggi di Ad Manager, AdSense e AdMob, supportano la versione 2.2 del TCF per i messaggi relativi ai regolamenti europei, in linea con i requisiti aggiornati di IAB per le CMP.
Per aiutare i publisher a gestire gli errori e le configurazioni errate relativi al lancio della versione 2.2 del Transparency & Consent Framework di IAB Europe, forniamo un report sugli errori rilevati.
Questo articolo fornisce maggiori informazioni su come correggere gli errori di implementazione della versione 2.2 del TCF, tra cui:
Linee guida aggiornate
Aggiornamenti
- Promemoria sul requisito del TCF che prevede di ottenere di nuovo il consenso ogni 13 mesi:
Ai sensi delle norme del TCF di IAB, devi ricordare agli utenti le loro scelte sul consenso almeno una volta ogni 13 mesi (390 giorni). Se la decisione relativa al consenso risale a più di 13 mesi fa, la stringa TC non sarà più considerata valida e Google non pubblicherà annunci per l'utente. Ti consigliamo di usare la CMP per ricordare agli utenti le loro scelte sul consenso prima che venga raggiunto il limite di 13 mesi.
- Il tipo di errore 3.2 è stato eliminato. Le stringhe TC aggiornate negli ultimi 13 mesi rimarranno valide.
Correzioni degli errori comuni
Procedi come descritto di seguito per risolvere alcuni degli errori più comuni in Ad Manager, AdSense e AdMob.
Valuta l'opportunità di ottenere nuovamente il consenso degli utenti con stringhe TC senza monetizzazione(Errori 1.1, 3.1, 4.1, 5.1, 5.2 e 6.1)
Errore o errori correlati
Linee guida aggiornate
Valuta la possibilità di richiedere di nuovo il consenso agli utenti.
Motivazione
I publisher trarranno vantaggio dal richiedere nuovamente il consenso se in precedenza hanno utilizzato stringhe con ambiti "Out-of-band" (Fuori banda) o "Global scope" (Ambito globale) oppure ID CMP non validi (dai test), ID GVL non validi (dai test) o nei casi in cui Google non era compresa tra i fornitori con consenso appropriato in un qualsiasi momento dell'implementazione.
Errori 1.1, 1.2, 1.3. È importante verificare se questi errori rappresentano un volume di traffico significativo. In questo caso, tieni presente che potrebbe esserci un problema sulla CMP e assicurati che Google riceva il consenso per le finalità necessarie, oltre a quelle di consenso E interesse legittimo in qualità di fornitore (ID fornitore 755).
Specifica IAB
In base alle specifiche IAB, le CMP possono memorizzare nella cache le stringhe per il consenso per 13 mesi.
AddEventHandler
entro 500 ms(Errori 2.1a, 2.1b, 2.0a, 2.0b e 2.0c)
Errore o errori correlati
Errore 2.1a. Queste istruzioni possono essere applicate anche agli errori 2.1b, 2.0a, 2.0b e 2.0c.
Linee guida aggiornate
Anche se non esiste più un requisito di timeout, consigliamo una revisione delle implementazioni da parte delle CMP per garantire che venga data risposta immediata alle chiamate a AddEventListener getTCData
.
Se una CMP non risponde, la richiesta potrebbe non venire monetizzata.
Motivazione
Google ottempera alla specifica IAB che stabilisce che una CMP deve rispondere immediatamente alla funzione AddEventListener
. In caso contrario, la richiesta potrebbe non venire monetizzata.
Inoltre, le risposte della CMP fanno parte della catena di eventi che influenza la rapidità con la quale è possibile effettuare una richiesta di annuncio. La riduzione dell'intervallo tra il caricamento pagina e le richieste di annunci comporta un calo delle impressioni perse per il publisher.
Specifica IAB
Specifica IAB applicabile: specifica AddEventListener di IAB (su GitHub)
AddEventListener
deve essere chiamato immediatamente al momento della registrazione con i dati TC correnti, anche se la CMP è in stato loading
(caricamento in corso) e ha dati TC incompleti. In questo modo, allo script di chiamata viene concesso di accedere al relativo listenerId
registrato. Inoltre, a ogni modifica della stringa TC deve essere chiamato il callback, a meno che non venga rimosso usando RemoveEventListener
.Centro norme
Il Centro norme invia una notifica ai publisher se un'app o un sito non sono conformi ai requisiti per la gestione del consenso di Google.
Report sugli errori
Informeremo i publisher nell'interfaccia utente del prodotto se rileviamo un problema nella stringa TC associata a uno o più dei loro siti o delle loro app. Nella pagina "Consenso degli utenti dell'UE" del proprio account, i publisher possono fare clic su Scarica il report sugli errori relativi al TCF per scaricare un report dettagliato sugli errori rilevati negli ultimi 7 giorni.
- Ad Manager: fai clic su Amministratore e poi su Consenso degli utenti dell'UE.
- AdMob e AdSense: fai clic su Controlli di blocco e poi su Consenso degli utenti dell'UE.
Il report conterrà le seguenti informazioni su ciascun errore rilevato:
- Dominio/MobileAppID: il sito o l'app mobile con una configurazione errata.
- Percorso unità pubblicitaria: l'unità pubblicitaria associata all'errore.
- Codice di errore: il codice assegnato all'errore.
- Numero errori: il numero di query contenenti l'errore che sono state osservate durante la settimana precedente.
- Data dell'ultimo rilevamento: l'ultima data in cui è stato rilevato l'errore.
I publisher possono utilizzare i codici di errore elencati nel report per trovare le azioni suggerite da intraprendere nelle seguenti tabelle per la risoluzione dei problemi e risolvere gli errori.
Risoluzione dei problemi
Per aiutare i publisher a correggere configurazioni errate delle integrazioni della versione 2.2 del TCF di IAB, abbiamo creato le seguenti tabelle che raggruppano i tipi di errori delle stringhe TC più comuni e i relativi consigli per la risoluzione dei problemi.
Utilizza le tabelle per comprendere i problemi che si verificano a livello di richiesta di annuncio e il corrispondente comportamento del sistema.
Scenari di consenso limitato
Tutti e tre questi scenari hanno sempre la precedenza sugli errori di configurazione non corretta, anche se per una determinata richiesta sono presenti più errori.
Scenario | Descrizione | Azione suggerita |
---|---|---|
1.1 | Il consenso o l'interesse legittimo è stato negato per Google in qualità di fornitore. | Verifica se l'utente ha rifiutato intenzionalmente Google come fornitore, se si sono verificati errori di implementazione della CMP o se sono presenti limitazioni per i publisher. |
1.2 | Nessun consenso per lo Scopo 1 per i paesi SEE e il Regno Unito. |
Verifica se l'utente ha intenzionalmente negato il consenso per lo Scopo 1 o se ciò è dovuto a errori di implementazione della CMP. I publisher svizzeri devono assicurarsi di impostare correttamente i campi
PublisherCC e PurposeOneTreatment se non chiedono agli utenti il consenso. A partire da dicembre 2021, non controlleremo più il trattamento di |
1.3 | Ha il consenso per lo Scopo 1, ma non presenta basi giuridiche per gli annunci di base. |
Verifica se l'utente ha rifiutato intenzionalmente gli interessi legittimi per gli altri scopi o se ciò è dovuto a errori di implementazione della CMP. |
Configurazione errata
Le richieste di annunci non verranno soddisfatte se esistono errori di configurazione.
Errore | Descrizione | Azione suggerita |
---|---|---|
2.1a | Il tag o l'SDK non riceve una stringa TC perché lo stato della CMP è stub (bozza), loading (caricamento in corso) o error (errore). |
Se vuoi richiamare manualmente la funzione per richiedere gli annunci, assicurati che la risposta a Se non richiami manualmente la funzione per richiedere gli annunci, assicurati che la tua CMP implementi il supporto per |
2.1b |
Entrambe le condizioni sono soddisfatte:
|
Chiedi alla tua CMP di verificare che le sue API siano implementate correttamente in base alla specifica tecnica del TCF di IAB. |
2.2a |
La stringa TC non è analizzabile perché non è codificata in Base64. Esempio: |
Le CMP (o publisher) devono inviare solo dati codificati in Base64 nei parametri gdpr_consent= . |
2.2b |
La stringa TC non è analizzabile a causa di un errore di decodifica. Esempio: include un numero errato di bit |
La CMP deve correggere gli errori di implementazione della stringa TC. |
2.2c |
La stringa TC non è analizzabile a causa di un errore nei dati. Esempio: timestamp errato, ID fornitore troppo lungo |
La CMP deve correggere gli errori di implementazione della stringa TC. |
Problemi relativi alla stringa TC
Problemi con la stringa TC associata a una richiesta di annuncio. Le richieste di annunci verranno ignorate e non soddisfatte.
Errore | Descrizione | Azione suggerita |
---|---|---|
3.1 | ID CMP non valido. |
Assicurati che venga utilizzata una CMP convalidata da IAB e che il relativo ID sia impostato correttamente nelle stringhe TC. Se una CMP era valida quando è stata generata una stringa TC, ma è stata successivamente eliminata da IAB, devi ottenere nuovamente il consenso utilizzando una CMP valida. |
3.2 | Non più in uso. | Nessuna. Significato precedente: la data di creazione della stringa TC risale a più di 13 mesi fa. |
È necessario ottenere nuovamente il consenso
È necessario ottenere il consenso dell'utente. Se un utente ha fornito il consenso più di 13 mesi fa o mentre utilizzava una versione dell'elenco GVL in cui Google non era ancora presente, devi ottenere nuovamente il consenso dell'utente, altrimenti le richieste di annunci verranno ignorate e non soddisfatte.
Errore | Descrizione | Azione suggerita |
---|---|---|
3.3 | La data dell'ultimo aggiornamento della stringa TC risale a più di 13 mesi fa. |
La CMP deve eliminare la vecchia stringa TC e ottenere nuovamente il consenso. Si prevede che un numero ridotto di questi errori possa verificarsi se le richieste di annunci vengono inviate con una stringa TC scaduta prima che la CMP abbia invalidato e ottenuto nuovamente il consenso dell'utente. Se nella tua app utilizzi le soluzioni di Google per la gestione del consenso e l'SDK UMP, verifica che quest'ultimo sia stato implementato correttamente e che |
4.1 | La stringa TC è stata generata utilizzando una versione dell'elenco GVL in cui Google non era ancora presente. | Ottieni nuovamente il consenso utilizzando una versione aggiornata dell'elenco GVL. |
Ambito globale e fuori banda
Di seguito sono riportati i problemi relativi ad ambito globale e fuori banda (Ad Manager, AdMob e AdSense). Gli annunci non vengono pubblicati se la stringa TC indica "out-of-band" (fuori banda) o "global scope" (ambito globale).
Errore | Descrizione | Azione suggerita |
---|---|---|
5.1 | La stringa TC consente il consenso out-of-band (fuori banda). | Chiedi alla CMP di rimuovere gli indicatori out-of-band (fuori banda) dalle stringhe TC. |
5.2 | Stringa TC con ambito globale. | Chiedi alla CMP di aggiornare le stringhe TC in modo che siano specifiche per il servizio. |
Pubblicazione di annunci con limitazioni
Gli annunci con limitazioni verranno pubblicati.
Errore | Descrizione | Azione suggerita |
---|---|---|
6.1 | La versione della stringa TC è 1 o 1.1 (stringa della versione 1.0). |
La CMP deve inviare le stringhe della versione 2.2 del TCF. |
Google gestirà i problemi
Quando si verificano questi problemi, Google provvede a mitigarli direttamente, quando necessario, e procede alla normale gestione del TCF.
Errore | Descrizione | Azione suggerita |
---|---|---|
7.1 | gdprApplies non è definito o è impostato su un valore non valido o incomprensibile, ma è presente una stringa TC valida. |
N/A |
7.2 | La stringa TC è stata generata con una versione dell'elenco GVL più recente rispetto alla versione corrente nota alla tecnologia di pubblicazione di annunci di Google. | N/A |
7.3 | Alcuni scopi, funzionalità e/o fornitori non rientrano nell'intervallo (sconosciuto). | N/A |
7.4 | La stringa TC contiene una versione tcf_policy_version meno recente dell'ultimo elenco GVL. |
La CMP deve eliminare la vecchia stringa TC e ottenere nuovamente il consenso utilizzando l'elenco GVL più recente. |
7.5 |
Una richiesta contiene |
N/A |
7.6 | È presente un codice paese del publisher non valido, ma è disponibile il consenso per lo Scopo 1. | La CMP deve correggere gli errori di implementazione della stringa TC. |
7.7 | Codice lingua non valido. | La CMP deve correggere gli errori di implementazione della stringa TC. |
7.8 | Il campo della versione della stringa TC non è né 1 né 2 . |
La CMP deve correggere gli errori di implementazione della stringa TC richiedendo un nuovo consenso se viene rilevata una stringa TC non valida. Se nella tua app utilizzi le soluzioni di Google per la gestione del consenso e l'SDK UMP, verifica che quest'ultimo sia stato implementato correttamente e che |
7.9 | La versione della stringa CA non è né 1 né 2 . |
La CMP deve impostare la versione della stringa CA su 1 o su 2 . |
Problemi relativi alla stringa CA
Quando si verificano questi problemi, Google tratta la stringa Consenso aggiuntivo (CA) come non valida e nessun fornitore aggiuntivo sarà considerato al di fuori della stringa TC.
Errore | Descrizione | Azione suggerita |
---|---|---|
8.1 | La stringa AC non utilizza il separatore di versione (~ ). |
La CMP deve utilizzare "~ " come secondo carattere della stringa AC, per separare il numero di versione dall'elenco dei fornitori autorizzati. |
8.2 | La stringa AC contiene un elenco di fornitori che non rispetta la formattazione prevista (elenco di int64 separati da ".") | La CMP deve correggere gli errori di implementazione della stringa CA. |
Certificazione della CMP
Quando si verificano questi problemi, Google tenta di pubblicare annunci non personalizzati.
Errore | Descrizione | Azione suggerita |
---|---|---|
9.1 | La CMP che utilizza il TCF ed è presente nella richiesta non è certificata da Google. | La CMP deve essere certificata da Google. |
Nessun indicatore TCF nelle richieste di annunci
Quando si verificano questi problemi, Google tenta di pubblicare annunci con limitazioni.
Errore | Descrizione | Azione suggerita |
---|---|---|
10.1 |
La richiesta proviene dal SEE, dal Regno Unito o dalla Svizzera, ma non contiene indicatori TCF. |
Il publisher deve eseguire l'integrazione con una CMP che utilizza il TCF ed è certificata da Google. |