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 sui siti web, consulta Risoluzione dei 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:

• Verificare se il tuo sito web imposta lo stato del consenso predefinito corretto prima dell'attivazione di qualsiasi tag. Il valore predefinito appropriato dipende dalle policy della tua organizzazione.
• Verificare se il tuo sito web aggiorna correttamente gli stati del consenso dopo che i visitatori concedono o negano il consenso.
• Verificare quali tag controllano quali tipi di consenso.
• Verificare se i tipi di consenso richiesti sono stati concessi quando è stato attivato ogni tag e se il tag ha superato i controlli per qualsiasi consenso aggiuntivo richiesto.

Tag Assistant supporta i seguenti meccanismi di consenso:

• gtag consent comandi
• Tag creati da un modello di modalità di consenso di Tag Manager
• Transparency and Consent Framework (TCF)

Prima di iniziare

Puoi utilizzare Tag Assistant su tutti i browser. Per ottenere risultati ottimali nella risoluzione dei problemi, utilizza Google Chrome e installa l'estensione del browser Tag Assistant Companion.

Verificare il funzionamento della modalità di consenso

I passaggi che seguono mostrano come eseguire il debug della modalità di consenso. Se hai impostato valori predefiniti o banner del consenso specifici per la regione, ripeti questi passaggi con località geografiche simulate diverse. Scopri come impostare le località in Chrome.

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 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 di 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 siano stati aggiornati 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 Aggiornamento nella pagina.

      

6. Verifica 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

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 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, verifica che siano stati aggiornati 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 Aggiornamento nella pagina.

      

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 viene aggiornato
• 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 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.

Tag Manager

Se utilizzi Tag Manager, l'approccio consigliato per l'implementazione della modalità di consenso è 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 tag Nuovo. 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 all'area di lavoro.
5. Compila i campi nel modello di tag. Il tuo fornitore di CMP ha ulteriori 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.

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 per 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.

Consenso predefinito non impostato

L'impostazione di uno stato predefinito del consenso per tutti i parametri della modalità di consenso 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 dello stato predefinito del consenso non impostato

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.

gtag.js

Sposta tutto il codice che chiama i comandi dello stato predefinito del consenso di gtag più in alto nella pagina, sopra qualsiasi snippet del 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.

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:

1. Il visitatore apre la pagina.
2. Il tag annuncio viene attivato.
3. Il consenso predefinito è impostato su negato.

Tag Assistant segnala un errore:

Come risolvere il problema dell'impostazione del consenso predefinito

Tag Manager

Se un tag modello di consenso ha impostato il consenso predefinito:

1. Modifica l'attivatore del tag modello di scrittura del consenso in modo che venga attivato in 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 della pagina, utilizza l'attivatore Inizializzazione - Tutte le pagine.

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

gtag.js

Sposta tutto il codice che chiama i comandi dello stato predefinito del consenso di gtag più in alto nella pagina, sopra qualsiasi snippet del 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.

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 consenso update. 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

Tag Manager

Se utilizzi un tag modello di consenso per impostare il consenso predefinito, assicurati che aggiorni anche lo stato del consenso. Per ulteriori informazioni, consulta la documentazione del tuo fornitore di 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 modello personalizzato.

gtag.js

Utilizza il comando update di gtag.js per aggiornare lo stato del consenso dopo che un visitatore ha interagito con il tuo banner. Assicurati di avere un meccanismo di aggiornamento per ogni parametro per cui hai impostato uno stato predefinito del consenso e che un utente possa aggiornare il consenso sia a granted sia a 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>

Lo stato del consenso non si adatta alle impostazioni regionali

Puoi configurare stati predefiniti del consenso diversi a seconda della regione del visitatore. Se hai implementato valori predefiniti del consenso per diverse regioni, prova a seguire questi passaggi per verificare che le impostazioni funzionino.

Come risolvere il problema della modalità di consenso che non si adatta alla regione dell'utente

Tag Manager

1. Nel browser, imposta la località del visitatore su una regione che vuoi verificare. Scopri come impostare le località 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, consulta Configurare le regioni geografiche.

gtag.js

1. Nel browser, imposta la località del visitatore su una regione che vuoi verificare. Scopri come impostare le località 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 del 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 policy dell'organizzazione. Scopri come configurare le regioni geografiche.

Passaggi successivi

Il tag Google è sensibile al consenso, quindi ne 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 saranno meno precise e la creazione di modelli di comportamento in Google Analytics non sarà disponibile. Sblocca il tag Google per ricevere i migliori risultati di misurazione.

Scopri di più sui risultati dell'impatto della modalità di consenso.