Questo articolo è rivolto a sviluppatori e 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, vedi Risoluzione dei problemi relativi al TCF. Per verificare le implementazioni dell'app, consulta le istruzioni per Android e iOS.
Puoi controllare l'implementazione della modalità di consenso per:
- Se il tuo sito web imposta lo stato del consenso predefinito corretto prima dell'attivazione di qualsiasi tag. Il valore predefinito appropriato 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 quali tipi di consenso.
- Se i tipi di consenso richiesti sono stati concessi quando ogni tag è stato attivato e se il tag ha superato i controlli per qualsiasi consenso aggiuntivo richiesto.
Tag Assistant supporta i seguenti meccanismi di consenso:
- Comandi gtag
consent - 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 ottenere i migliori risultati 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 impostato valori predefiniti o banner del consenso specifici per regione, ripeti questi passaggi con diverse località geografiche simulate. Scopri come impostare le posizioni 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 se nella pagina è impostato correttamente il consenso predefinito:
- In Riepilogo, seleziona il primo evento Consenso.
- Nella sezione Chiamata API, verifica che siano impostati i seguenti parametri:
ad_storage,ad_personalization,ad_user_data,analytics_storage. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e controlla la colonna Valore predefinito nella pagina.

Verifica se nella pagina il consenso è stato aggiornato in base all'interazione con il banner del consenso:
- In Riepilogo, seleziona l'evento Consenso più recente.
- Nella sezione Chiamata API, verifica che i seguenti parametri
siano stati aggiornati:
ad_storage,ad_personalization,ad_user_data,analytics_storage. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e 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 se nella pagina è impostato correttamente il consenso predefinito:
- In Riepilogo, seleziona il primo evento Consenso.
- Nella sezione Chiamata API, verifica che siano impostati i seguenti parametri:
ad_storage,ad_personalization,ad_user_data,analytics_storage. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e controlla la colonna Valore predefinito nella pagina.

Verifica se nella pagina il consenso è stato aggiornato in base all'interazione con il banner del consenso:
- In Riepilogo, seleziona l'evento Consenso più recente.
- Nella sezione Chiamata API, verifica che i seguenti parametri
siano stati aggiornati:
ad_storage,ad_personalization,ad_user_data,analytics_storage. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e la colonna Aggiornamento nella pagina.

Verifica quali tag sono stati attivati o bloccati in base allo 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 visualizzare le istruzioni per la relativa risoluzione:
- Scheda Consenso vuota
- Consenso predefinito non impostato
- Consenso predefinito impostato troppo tardi
- Lo stato del consenso non si aggiorna
- Lo stato del consenso non si adatta alle impostazioni regionali
Scheda Consenso vuota
La scheda Consenso di Tag Assistant è vuota quando la modalità di consenso non è implementata nella pagina.
Come risolvere il problema del mancato caricamento della modalità di consenso
Per risolvere il problema, devi implementare la modalità di consenso. Le istruzioni riportate di seguito presuppongono che tu abbia già un banner del consenso sul tuo sito web.
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 passo passo: come configurare la modalità di consenso
Se utilizzi 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 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 è l'utilizzo di 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.
- Configura un tag Nuovo. Fai clic su Configurazione tag e apri la Galleria modelli della community.
- Cerca il tag del tuo fornitore di CMP e fai clic su Aggiungi al workspace.
- Compila i campi nel modello di tag. Il tuo fornitore di CMP ha maggiori informazioni sui campi obbligatori.
- In Attivazione, seleziona l'attivatore Inizializzazione del consenso - Tutte le pagine.
- Salva il tag e visualizza l'anteprima del contenitore per verificare il funzionamento della modalità di consenso.
Se gestisci il tuo banner del consenso o 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 aiuta a 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 risolvere il problema del consenso predefinito non impostato
gtag.js
Sposta tutto il codice che chiama i comandi predefiniti per il consenso gtag più in alto nella pagina, sopra qualsiasi snippet di tag o altro codice che potrebbe utilizzare il consenso.
Imposta i seguenti parametri di 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 scoprire come impostare il consenso predefinito utilizzando il modello di Tag Manager.
Assicurati che il tag carichi i valori predefiniti del consenso per almeno questi quattro parametri:
ad_storagead_user_dataad_personalizationanalytics_storage
Se gestisci il tuo banner del consenso o la tua CMP non si integra automaticamente con la modalità di consenso, implementa la modalità di consenso manualmente.
Consenso predefinito impostato troppo tardi
Nel sito web deve essere impostato lo stato del consenso predefinito prima che qualsiasi tag o altro codice utilizzi o aggiorni il consenso. Impostare il valore predefinito troppo tardi potrebbe non produrre l'effetto previsto. Scopri di più sui requisiti per il consenso di Google.
Ad esempio, nello scenario seguente, il tag annuncio ha già letto o scritto un cookie prima che venga impostato il consenso predefinito:
- Il visitatore apre la pagina
- Attivazioni dei tag annuncio
- Consenso predefinito impostato su Negato
Tag Assistant segnala un errore:
![]()
Come risolvere il problema dell'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 qualsiasi snippet di tag o altro codice che potrebbe utilizzare il consenso.
Imposta i seguenti parametri di 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 insieme di tag modello di consenso ha impostato il consenso predefinito:
- Modifica l'attivatore del tag modello di scrittura del consenso in modo che si attivi in base 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 banner del consenso, quest'ultimo dovrebbe inviare un comando di updateconsenso. Se lo stato del consenso non si aggiorna, controlla se è stato implementato
un meccanismo di aggiornamento.
Come risolvere il problema dell'aggiornamento della modalità di consenso
gtag.js
Utilizza il comando update gtag.js per aggiornare lo stato del consenso dopo che un visitatore
ha interagito con il tuo banner. Assicurati di disporre di un meccanismo di aggiornamento per
ogni parametro per cui hai impostato un consenso predefinito e che un utente possa
aggiornare il proprio consenso sia per granted che per denied.
L'esempio seguente mostra come la funzione consentGrantedAdStorage
aggiorna lo stato del consenso quando un visitatore accetta i cookie pubblicitari 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 modello di consenso per impostare il consenso predefinito, assicurati che aggiorni anche lo stato del consenso. Per saperne di più, consulta la documentazione del fornitore di 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 valori predefiniti del consenso per diverse regioni, prova a svolgere i seguenti passaggi per verificare che le impostazioni funzionino.
Come risolvere il problema della modalità di consenso che non si adatta alla regione dell'utente
gtag.js
- Nel browser, imposta la posizione del visitatore su una regione che vuoi verificare. Scopri come impostare le posizioni 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 consenso regionale predefinito per un parametro, ma non per l'altro. Quando controlli il comportamento regionale, assicurati che tutti i parametri si comportino come indicato dalle norme aziendali. Scopri come configurare le regioni geografiche.
Tag Manager
- Nel browser, imposta la posizione del visitatore su una regione che vuoi verificare. Scopri come impostare le posizioni 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 Configurare le regioni geografiche.
Passaggi successivi
Il tag Google è sensibile al consenso, quindi regola il comportamento in base al consenso dell'utente. Se blocchi il caricamento del tag Google finché un utente non concede il consenso, le conversioni modellate sono meno precise e la creazione di modelli di comportamento in Google Analytics 4 non è disponibile. Sblocca il tag Google per ricevere i migliori risultati di misurazione.
Scopri di più sui risultati dell'impatto della modalità di consenso.