Risolvere i problemi relativi alla modalità di consenso con Tag Assistant

Questo articolo è rivolto a sviluppatori e amministratori che vogliono verificare e risolvere i problemi relativi all'implementazione della modalità di consenso sul proprio sito web. Per le implementazioni del TCF su siti web, consulta Risolvere i 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 dei 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 il consenso aggiuntivo richiesto.

Tag Assistant supporta i seguenti meccanismi di consenso:

• Comandi consent 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 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 passaggi seguenti mostrano come eseguire il debug della modalità di consenso. Se hai impostato valori predefiniti specifici per regione o banner del consenso, ripeti questi passaggi con diverse posizioni 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:

1. Apri Google Tag Assistant.

2. Inserisci l'URL del tuo sito web. Si apre una nuova scheda con il tuo sito web.

   Nota: se in Tag Assistant appare il messaggio Impossibile connettersi, il caricamento del tag Google potrebbe essere bloccato.

3. Sul tuo sito web, apri il banner dei cookie e accetta tutti i parametri.

   Nota: se il tag Google è stato bloccato, Tag Assistant ora dovrebbe essere in grado di connettersi al tuo sito.

4. In Tag Assistant, verifica se nella pagina è impostato correttamente il consenso predefinito:

   1. In Riepilogo, seleziona il primo evento Consenso.
   2. Nella sezione Chiamata API, verifica che siano impostati i seguenti parametri: ad_storage, ad_personalization,, ad_user_data, analytics_storage.

   3. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e la colonna Valore predefinito nella pagina.

      

5. Verifica se nella pagina il consenso è stato aggiornato in base all'interazione con il banner del consenso:

   1. In Riepilogo, seleziona l'evento Consenso più recente.
   2. Nella sezione Chiamata API, controlla che i seguenti parametri siano stati aggiornati: ad_storage, ad_personalization, ad_user_data, analytics_storage.

   3. 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:

1. Apri Google Tag Assistant.

2. Inserisci l'URL del tuo sito web. Si apre una nuova scheda con il tuo sito web.

   Nota: se in Tag Assistant appare il messaggio Impossibile connettersi, il caricamento del contenitore Tag Manager potrebbe essere bloccato.

3. Sul tuo sito web, apri il banner dei cookie e accetta tutto.

   Nota: se il contenitore è stato bloccato, Tag Assistant ora dovrebbe essere in grado di connettersi al tuo sito.

4. In Tag Assistant, verifica se nella pagina è impostato correttamente il consenso predefinito:

   1. In Riepilogo, seleziona il primo evento Consenso.
   2. Nella sezione Chiamata API, verifica che siano impostati i seguenti parametri: ad_storage, ad_personalization,, ad_user_data, analytics_storage.

   3. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e la colonna Valore predefinito nella pagina.

      

5. Verifica se nella pagina il consenso è stato aggiornato in base all'interazione con il banner del consenso:

   1. In Riepilogo, seleziona l'evento Consenso più recente.
   2. Nella sezione Chiamata API, verifica che i seguenti parametri siano stati aggiornati: ad_storage, ad_personalization, ad_user_data,analytics_storage.

   3. In alternativa, in Output della sezione dei tag, seleziona la scheda Consenso e la colonna Aggiornamento nella pagina.

      

6. Controlla quali tag sono stati attivati o bloccati in base allo stato del consenso:

   1. In Riepilogo, seleziona la scheda Tag.
   2. 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 di 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

Nota: la modalità di consenso è stata aggiornata a novembre 2023. Imposta i seguenti parametri di consenso:

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Passaggio dopo passaggio: come configurare la modalità di consenso

Se utilizzi una piattaforma di gestione del consenso (CMP) per caricare un banner del consenso:

1. Verifica se la tua CMP supporta la modalità di consenso di Google.
2. Controlla le impostazioni della CMP per attivare la modalità di consenso di Google.
3. 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 prevede l'utilizzo di una piattaforma di consenso che fornisce un modello di Tag Manager. Per configurare un banner del consenso utilizzando Tag Manager:

1. Apri Google Tag Manager
2. Nell'area di lavoro, apri il menu Tag.
3. Configura un Nuovo tag. Fai clic su Configurazione tag e apri la Galleria modelli della community.
4. Cerca il tag del tuo fornitore di CMP e fai clic su Aggiungi allo spazio di lavoro.
5. Compila i campi nel modello di tag. Il tuo fornitore CMP ha maggiori informazioni sui campi obbligatori.
6. In Attivazione, seleziona l'attivatore Inizializzazione del consenso - Tutte le pagine.
7. 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 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 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 correggere il valore predefinito per il consenso non impostato

gtag.js

Sposta tutto il codice che chiama i comandi predefiniti per il consenso di gtag più in alto nella pagina, sopra eventuali 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_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

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, nel seguente scenario, il tag annuncio ha già letto o scritto un cookie prima che venga impostato il consenso predefinito:

1. Il visitatore apre la pagina
2. Attivazione dei tag annuncio
3. 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 di gtag più in alto nella pagina, sopra eventuali 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 tag modello di consenso imposta il consenso predefinito:

1. Modifica l'attivatore del tag del modello di scrittura del consenso in modo che si attivi con Inizializzazione del consenso.
2. 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.

Attenzione: non utilizzare un tag HTML personalizzato in Tag Manager per chiamare il comando gtag consent. Imposta invece gli stati del consenso utilizzando un tag modello che utilizza l'API di modelli personalizzati.

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 update per il consenso. Se lo stato del consenso non si aggiorna, controlla se è stato implementato un meccanismo di aggiornamento.

Come risolvere i problemi di 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 valore predefinito per il consenso e che un utente possa aggiornare il proprio consenso sia su granted sia su denied.

L'esempio seguente mostra come la funzione consentGrantedAdStorage aggiorna lo stato del consenso quando un visitatore accetta i cookie di Google Ads in un banner per il 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 fornitore della CMP.

Attenzione: non utilizzare un tag HTML personalizzato in Tag Manager per chiamare il comando gtag consent. Imposta invece gli stati del consenso utilizzando un tag modello che utilizza l'API di modelli personalizzati.

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 il funzionamento delle impostazioni.

Come risolvere il problema di mancata adattabilità della modalità di consenso alla regione dell'utente

gtag.js

1. Nel browser, imposta la località del visitatore su una regione che vuoi verificare. Scopri come impostare le posizioni in Chrome.
2. Verifica il funzionamento della modalità di consenso.

3. 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 regionale per un parametro, ma non per l'altro. Quando controlli il comportamento regionale, assicurati che tutti i parametri si comportino come indicato dalle norme della tua organizzazione. Scopri come configurare le regioni geografiche.

Tag Manager

1. Nel browser, imposta la località del visitatore su una regione che vuoi verificare. Scopri come impostare le posizioni in Chrome.
2. Verifica il funzionamento della modalità di consenso.
3. Se la modalità di consenso non si adatta alla regione dell'utente, controlla le impostazioni del tag di consenso e consulta la pagina Configurare le regioni geografiche.

Passaggi successivi

Il tag Google è sensibile al consenso, pertanto 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.