Consent Mode con gtag
Questa pagina spiega come il banner gestisce Google Consent Mode su un sito con gtag.js e senza Google Tag Manager. Indica chi manda default e update e come ottenere Basic o Advanced.
A chi serve
A chi ha il tag Google (gtag.js) nel codice della pagina. Con Google Tag Manager vedi Con Google Tag Manager.
Prerequisiti
Prima di cominciare controlla che:
- lo snippet del banner sia nella pagina. Vedi Snippet HTML;
- la Google Consent Mode sia attiva nello spazio web. Negli spazi web nuovi lo è già. In Cookie Banner > Impostazioni avanzate la tendina Supporto alla Google Consent Mode mostra Attiva.
Chi manda cosa
| Comando | Chi lo manda | Quando |
|---|---|---|
gtag('consent', 'default', …) | lo snippet del banner, in testa, in modo sincrono | prima di ogni tag Google che la pagina carica dopo lo snippet |
gtag('consent', 'update', …) | il banner | quando il visitatore sceglie, e quando carica un consenso già salvato |
{ event: 'avacy_consent_update' } | il banner | subito dopo l'update |
Il default
Lo snippet manda un unico default globale. Tutti e sette i tipi di consenso (ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage, personalization_storage, security_storage) partono da denied. wait_for_update vale 500 ms.
Lo snippet non manda il suo default in due casi:
- la pagina ha già un
consent defaultneldataLayer; - la pagina ha il template GTM di Avacy, che imposta il default per conto suo.
Aggiungi un tuo consent default solo se vuoi valori diversi (vedi Tempi di attesa).
Gli update
Il banner manda l'update con i sette tipi a granted o denied, secondo le scelte del visitatore. Un tipo senza scelta resta denied.
Subito dopo l'update il banner mette nel dataLayer l'evento avacy_consent_update, senza altri dati. L'evento serve ai tag di Google Tag Manager che non sono tag Google. L'ordine è sempre update e poi evento. L'evento parte anche con un consenso già salvato.
Basic e Advanced
Il banner non ha un interruttore Basic o Advanced. La modalità dipende da come la pagina carica i tag Google.
Secondo Google, in Basic i tag Google non si caricano finché il visitatore non usa il banner. In Advanced si caricano all'apertura della pagina con i default di consenso (fonte).
| Modalità | Cosa fa la pagina | Cosa fa il banner |
|---|---|---|
| Advanced | Il tag Google si carica subito, dopo lo snippet. | Manda il default prima del tag, poi gli update. |
| Basic | Il tag Google è marcato e resta fermo. | Sblocca gli script marcati dopo l'update, quando il consenso richiesto è concesso. |
Advanced
- Metti lo snippet del banner nel
<head>, in alto, prima del tag Google. - Lascia il tag Google com'è, senza marcarlo.
<head>
<!-- 1. Snippet del banner, per primo -->
<script src="https://TENANT.avacy-cdn.com/v3/avacy-cmp-web.js?webspace=UUID-SPAZIO-WEB"></script>
<!-- 2. Tag Google, come al solito -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-XXXXXXXXXX');
</script>
</head>
Sostituisci TENANT, UUID-SPAZIO-WEB e G-XXXXXXXXXX con i tuoi valori. Copia lo snippet reale dalla dashboard.
Basic
Marca i tag Google perché restino fermi fino al consenso. Step, esempio e tabella dei numeri delle finalità sono in Tag Google con gtag, senza GTM.
Tempi di attesa (wait_for_update)
wait_for_update è il tempo, in millisecondi, che i tag Google aspettano un update prima di usare il default.
| Chi manda il default | Valore |
|---|---|
| Snippet del banner | 500 ms, fisso |
| Template GTM Avacy CMP | campo Wait for update, predefinito 2000 ms, modificabile |
Il valore dello snippet non è configurabile. Per un altro valore, manda un tuo consent default prima dello snippet. Lo snippet allora non manda il suo.
Con Google Tag Manager
Il template GTM Avacy CMP manda il default, anche per regione, con i valori scelti nel tag. Segna la pagina con __AVACY_GTM_CONSENT_TEMPLATE__ e il banner manda solo gli update. La guida al template è Installare il banner con Google Tag Manager.
Verifica
- Nella console del browser esegui
dataLayer.map(e => e.event || e[0] + ' ' + e[1]). - Controlla che
consent defaultcompaia prima dijseconfig. - Scegli nel banner ed esegui di nuovo il comando. Deve comparire
consent update, seguito daavacy_consent_update. - Accendi la debug mode e controlla l'esito. Vedi Ordine dei tag Google e debug mode.
Problemi comuni
I problemi più frequenti:
- La console segnala
LATE: un tag Google è partito prima del default. Metti lo snippet prima del tag. Se il tag passa da Google Tag Gateway, vedi Google Tag Gateway; - Tutti i tipi restano
denieddopo l'accettazione: controlla il pulsante premuto. La X in alto (Continua senza accettare) e Rifiuta tutto mandano tutti i tipi adenied. Accetta cookie li manda tutti agranted; - Il
defaultnon è neldataLayer: la pagina può usare undataLayercon un altro nome. Il banner legge solodataLayer.
Ultimo aggiornamento: 10/11/2026.