Questo articolo è rivolto agli sviluppatori e agli amministratori che vogliono verificare e risolvere i problemi relativi all'implementazione della modalità di consenso sul loro sito web. Per le implementazioni del TCF sui siti web, consulta Risolvere i problemi relativi al TCF. Per verificare le implementazioni delle app, consulta le istruzioni per Android e iOS.
Puoi controllare l'implementazione della modalità di consenso per:
- Indica se il tuo sito web imposta lo stato del consenso predefinito corretto prima dell'attivazione di qualsiasi tag. L'impostazione predefinita appropriata dipende dai criteri della tua organizzazione.
- Se il tuo sito web aggiorna correttamente gli stati del consenso dopo che i visitatori concedono o negano il consenso.
- Quali tag controllano e per quali tipi di consenso.
- Indica se i tipi di consenso richiesti sono stati concessi quando ogni tag è stato attivato e se il tag ha superato i controlli per eventuale consenso richiesto aggiuntivo.
Tag Assistant supporta i seguenti meccanismi di consenso:
- Comandi
consent
di gtag - Tag creati da un modello della modalità di consenso di Tag Manager
- Transparency and Consent Framework (TCF)
Prima di iniziare
Puoi utilizzare Tag Assistant su tutti i browser. Per risultati ottimali di risoluzione dei problemi, utilizza Google Chrome e installa l'estensione del browser Tag Assistant Companion.
Verificare il funzionamento della modalità di consenso
I seguenti passaggi mostrano come eseguire il debug della modalità di consenso. Se hai configurato valori predefiniti specifici per regione o banner del consenso, ripeti questi passaggi con posizioni geografiche simulate diverse. Scopri come impostare le località in Chrome.
gtag.js
Per verificare la configurazione del consenso per i siti web, avvia una nuova sessione di Tag Assistant:
- Apri Google Tag Assistant.
Inserisci l'URL del tuo sito web. Si apre una nuova scheda con il tuo sito web.
Sul tuo sito web, apri il banner dei cookie e accetta tutti i parametri.
In Tag Assistant, verifica che la pagina abbia impostato correttamente il consenso predefinito:
- Nel Riepilogo, seleziona il primo evento di Consenso.
- Nella sezione Chiamata API, verifica che siano stati impostati
i seguenti parametri:
ad_storage
,ad_personalization,
ad_user_data
,analytics_storage
. In alternativa, nella sezione Output del tag, seleziona la scheda Consenso e controlla la colonna Valore predefinito nella pagina.
Verifica se la pagina ha aggiornato il consenso in base all'interazione del banner del consenso:
- In Riepilogo, seleziona l'evento Consenso più recente.
- Nella sezione Chiamata API, verifica che siano stati aggiornati i seguenti parametri:
ad_storage
,ad_personalization
,ad_user_data
,analytics_storage
. In alternativa, nella sezione Output del tag, seleziona la scheda Consenso e controlla la colonna Aggiornamento nella pagina.
Tag Manager
Per verificare la configurazione del consenso per i siti web, avvia una nuova sessione di Tag Assistant:
- Apri Google Tag Assistant.
Inserisci l'URL del tuo sito web. Si apre una nuova scheda con il tuo sito web.
Sul tuo sito web, apri il banner dei cookie e accetta tutto.
In Tag Assistant, verifica che la pagina abbia impostato correttamente il consenso predefinito:
- Nel Riepilogo, seleziona il primo evento di Consenso.
- Nella sezione Chiamata API, verifica che siano stati impostati
i seguenti parametri:
ad_storage
,ad_personalization,
ad_user_data
,analytics_storage
. In alternativa, nella sezione Output del tag, seleziona la scheda Consenso e controlla la colonna Valore predefinito nella pagina.
Verifica se la pagina ha aggiornato il consenso in base all'interazione del banner del consenso:
- In Riepilogo, seleziona l'evento Consenso più recente.
- Nella sezione Chiamata API, verifica che siano stati aggiornati i seguenti parametri:
ad_storage
,ad_personalization
,ad_user_data
,analytics_storage
. In alternativa, nella sezione Output del tag, seleziona la scheda Consenso e controlla la colonna Aggiornamento nella pagina.
Controlla quali tag sono stati attivati o sono stati bloccati dallo stato del consenso:
- In Riepilogo, seleziona la scheda Tag.
- Fai clic su un tag per verificare se il suo comportamento ha rispettato le impostazioni relative al consenso.
Risolvere i problemi di configurazione del consenso
Seleziona un problema per ricevere istruzioni per la risoluzione dei problemi:
- Scheda Consenso vuota
- Consenso predefinito non impostato
- Consenso predefinito impostato troppo tardi
- Lo stato del consenso non viene aggiornato
- Lo stato del consenso non si adatta alle impostazioni regionali
Scheda Consenso vuota
La scheda Consenso di Tag Assistant è vuota quando nella pagina non è implementata la modalità di consenso.
Come risolvere il problema: la modalità di consenso non viene caricata
Per risolvere il problema, devi implementare la modalità di consenso. Le istruzioni riportate di seguito presuppongono che sul tuo sito web sia già presente un banner del consenso.
gtag.js
Video: come configurare la modalità di consenso
gtag('consent', 'default', { 'ad_storage': 'denied', 'analytics_storage': 'denied', 'ad_user_data': 'denied', 'ad_personalization': 'denied', });
Procedura dettagliata: configurare la modalità di consenso
Se usi una piattaforma di gestione del consenso (CMP) per caricare un banner del consenso:
- Verifica se la tua CMP supporta la modalità di consenso di Google.
- Controlla le impostazioni della CMP per attivare la modalità di consenso di Google.
- Verifica il funzionamento della modalità di consenso.
Se gestisci il tuo banner del consenso o se la tua CMP non si integra automaticamente con la modalità di consenso, implementa la modalità di consenso manualmente.
Tag Manager
Se utilizzi Tag Manager, l'approccio consigliato per l'implementazione della modalità di consenso consiste nell'utilizzare una piattaforma per il consenso che fornisce un modello di Tag Manager. Per configurare un banner del consenso utilizzando Tag Manager:
- Apri Google Tag Manager
- Nell'area di lavoro, apri il menu Tag.
- Imposta un nuovo tag. Fai clic su Configurazione tag e apri la Galleria modelli della community.
- Cerca il tag del tuo fornitore CMP e fai clic su Aggiungi all'area di lavoro.
- Compila i campi del modello di tag. Il tuo fornitore CMP ha maggiori informazioni sui campi obbligatori.
- In Attivazione, seleziona l'attivatore Inizializzazione del consenso - Tutte le pagine.
- Salva il tag e fai clic su Visualizza l'anteprima del contenitore per Verificare il funzionamento della modalità di consenso.
Se gestisci il tuo banner del consenso o se la tua CMP non si integra automaticamente con la modalità di consenso, implementa la modalità di consenso manualmente.
Consenso predefinito non impostato
L'impostazione di un valore predefinito per il consenso per tutti i parametri della modalità di consenso ti consente di gestire in modo efficiente il comportamento dei tag in base all'implementazione standard del banner del consenso. Scopri di più sui requisiti per il consenso di Google.
Come correggere il valore predefinito per il consenso non impostato
gtag.js
Sposta tutto il codice che chiama i comandi predefiniti per il consenso gtag più in alto nella pagina, sopra eventuali snippet di tag o altro codice che potrebbe utilizzare il consenso.
Imposta i seguenti parametri relativi al consenso:
gtag('consent', 'default', { 'ad_storage': 'denied', 'analytics_storage': 'denied', 'ad_user_data': 'denied', 'ad_personalization': 'denied', });
Non impostare gli stati del consenso predefiniti in modo asincrono.
Tag Manager
Se utilizzi un modello di tag CMP in Tag Manager, consulta la documentazione della CMP per sapere come impostare il consenso predefinito utilizzando il modello di Tag Manager.
Assicurati che il tag carichi le impostazioni predefinite per il consenso per almeno questi quattro parametri:
ad_storage
ad_user_data
ad_personalization
analytics_storage
Se gestisci il tuo banner del consenso o se la tua CMP non si integra automaticamente con la modalità di consenso, implementa la modalità di consenso manualmente.
Consenso predefinito impostato troppo tardi
Il sito web deve impostare lo stato del consenso predefinito prima che qualsiasi tag o altro codice utilizzi o aggiorni il consenso. L'impostazione di un valore predefinito troppo tardi potrebbe non produrre l'effetto previsto. Scopri di più sui requisiti per il consenso di Google.
Ad esempio, nel seguente scenario, il tag annuncio ha già letto o scritto un cookie prima che sia impostato il consenso predefinito:
- Il visitatore apre la pagina
- Attivazione del tag annuncio
- Consenso predefinito impostato su negato
Tag Assistant segnala un errore:
Come correggere l'impostazione del consenso predefinito
gtag.js
Sposta tutto il codice che chiama i comandi predefiniti per il consenso gtag più in alto nella pagina, sopra eventuali snippet di tag o altro codice che potrebbe utilizzare il consenso.
Imposta i seguenti parametri relativi al consenso:
gtag('consent', 'default', { 'ad_storage': 'denied', 'analytics_storage': 'denied', 'ad_user_data': 'denied', 'ad_personalization': 'denied', });
Non impostare gli stati del consenso predefiniti in modo asincrono.
Tag Manager
Se un tag del modello di consenso imposta il consenso predefinito:
- Modifica l'attivatore del tag del modello per la scrittura del consenso in modo che si attivi all'inizializzazione del consenso.
- Per tutti gli altri tag: attiva i tag dopo l'inizializzazione del consenso. Ad esempio, per attivare un tag al caricamento pagina, utilizza l'attivatore Inizializzazione - Tutte le pagine.
Lo stato del consenso non viene aggiornato
Quando il visitatore del sito web interagisce con il tuo banner del consenso, deve inviare un comando update
per il consenso. Se lo stato del consenso non viene aggiornato, verifica se è stato implementato
un meccanismo di aggiornamento.
Come correggere la modalità di consenso che non si aggiorna
gtag.js
Utilizza il comando update
di gtag.js per aggiornare lo stato del consenso dopo che un visitatore
ha interagito con il banner. Assicurati di disporre di un meccanismo di aggiornamento per
ogni parametro per cui hai impostato un valore predefinito per il consenso e che un utente possa
aggiornare il consenso sia su granted
che su denied
.
L'esempio seguente mostra in che modo la funzione consentGrantedAdStorage
aggiorna lo stato del consenso quando un visitatore accetta i cookie di Google Ads in un banner
del consenso.
<script>
function consentGrantedAdStorage() {
gtag('consent', 'update', {
'ad_storage': 'granted'
});
}
</script>
<!-- Invoke your consent function when a user interacts with your banner -->
<body>
...
<button onclick="consentGrantedAdStorage()">Yes</button>
...
</body>
Tag Manager
Se utilizzi un tag del modello di consenso per impostare il consenso predefinito, assicurati che aggiorni anche lo stato del consenso. Per saperne di più, consulta la documentazione del tuo provider CMP.
Lo stato del consenso non si adatta alle impostazioni regionali
Puoi configurare valori predefiniti per il consenso diversi a seconda della regione del visitatore. Se hai implementato le impostazioni predefinite del consenso per diverse regioni, prova a seguire questi passaggi per verificare che le impostazioni funzionino.
Come correggere la modalità di consenso che non si adatta alla regione dell'utente
gtag.js
- Nel browser, imposta la località del visitatore su una regione che vuoi verificare. Scopri come impostare le località in Chrome.
- Verifica il funzionamento della modalità di consenso.
Se la modalità di consenso non si adatta alla regione dell'utente, controlla il codice sorgente. Ad esempio:
gtag('consent', 'default', { 'analytics_storage': 'denied', 'region': ['ES', 'US-AK'] }); gtag('consent', 'default', { 'ad_storage': 'denied' });
L'esempio imposta un valore predefinito per il consenso a livello di regione per un parametro, ma non per l'altro. Quando controlli il comportamento a livello di regione, assicurati che tutti i parametri si comportino come indicato dai criteri dell'organizzazione. Scopri come configurare le regioni geografiche.
Tag Manager
- Nel browser, imposta la località del visitatore su una regione che vuoi verificare. Scopri come impostare le località in Chrome.
- Verifica il funzionamento della modalità di consenso.
- Se la modalità di consenso non si adatta alla regione dell'utente, controlla le impostazioni del tag di consenso, consulta l'articolo Configurare le regioni geografiche.
Passaggi successivi
Il tag Google è sensibile al consenso, pertanto regola il comportamento in base al consenso dell'utente. Se stai bloccando il caricamento del tag Google finché un utente non concede il consenso, le conversioni modellate sono meno accurate e la creazione di modelli di comportamento in Google Analytics 4 non è disponibile. Sblocca il tag Google per ricevere risultati di misurazione migliori.
Scopri di più sui risultati dell'impatto della modalità di consenso.