Integrazione con Google Tag Manager

Google Tag Manager (GTM) è uno strumento che ti permette di gestire e distribuire tag (frammenti di codice o pixel di tracciamento) sul tuo sito web senza dover modificare il codice del sito.

Se utilizzi Google Tag Manager (GTM) per inserire cookie nel tuo sito web e gestirne i contenuti, puoi configurarlo in modo che gli script siano controllati dalle preferenze di consenso scelte dai visitatori.

In questo articolo imparerai:

1. Come funziona
2. Creare nuove variabili
3. Creare nuovi trigger
4. Aggiungere i trigger ai tag

Come funziona

Per passare i dati a Google Tag Manager, la nostra applicazione utilizza il custom consent event tramite la Data Layer Variable.

La nostra applicazione utilizza l'oggetto dataLayer esistente oppure ne crea uno nuovo se non esiste già. Se il tuo negozio crea un oggetto dataLayer, assicurati che non sovrascriva quello creato dalla nostra applicazione.

Guida video

Creare nuove variabili

1. Apri il tuo container in Google Tag Manager.
2. Seleziona la scheda Variables dal menu principale. Appare la schermata Variable.
3. Crea una nuova User-Defined Variable.
4. Assegna un nome alla variabile. (Ti suggeriamo di chiamarla Pandectes C000x dove x è il numero della categoria che trovi qui, così saprai a cosa si riferisce)
5. Imposta il Variable Type su Data Layer Variable nella sezione Page Variables.
6. Imposta il Data Layer Variable Name su pandectes_categories.C000x dove x è il numero della categoria che trovi qui (ad esempio, per la categoria Functionality puoi inserire pandectes_categories.C0001).

7. Premi il pulsante Save.

Puoi seguire lo stesso procedimento creando una nuova variabile per ciascuna categoria della tua app, arrivando così ad avere 4 variabili in totale.

Creare nuovi trigger

In GTM, i trigger fanno sì che i tag si attivino o meno in base a determinati criteri. Potresti già avere vari trigger applicati ai tuoi tag.

Come parte della nostra integrazione di Google Consent Mode con GTM, creerai un trigger associato a ciascuna categoria di cookie.

Quando applichi questi trigger ai tuoi tag, i tag si attiveranno o meno in base al fatto che la categoria di cookie sia attiva o al consenso dato dall'utente.

Avrai bisogno di un trigger separato per ciascuna delle categorie di cookie sotto le quali bloccherai i cookie. Ad esempio, potresti avere un gruppo chiamato 'Performance Cookies', con un id di categoria C0002, che contiene i cookie impostati dal tuo tag Google Analytics.

Ogni trigger deve essere in linea con gli id di categoria impostati nella tua applicazione di consenso ai cookie. Puoi trovare gli id delle categorie di cookie nel custom consent event qui e nella sezione di integrazione Google Consent Mode all'interno dell'app, dove è presente un popup con la struttura del custom consent event.

Vogliamo che i trigger con l'id della categoria di cookie che crei vengano applicati ai tuoi tag esistenti in modo tale che il trigger della nostra app sia il fattore limitante per l'attivazione del tag. Questo può essere fatto in diversi modi. Di seguito ne sono descritti due.

Creare un Firing Trigger

1. Apri il tuo container in Google Tag Manager.
2. Seleziona la scheda Triggers dal menu principale. Appare la schermata Triggers.
3. Premi New. Appare la schermata Trigger Configuration.
4. Assegna un nome appropriato, ad esempio Pandectes Performance Allowed.
5. Premi Trigger Configuration e imposta il Trigger type su Custom Event.
6. Imposta Event name su Pandectes_Consent_Update.
7. Seleziona Some Custom Events e impostalo in modo che si attivi quando è vera la seguente condizione:

Pandectes C0001 equals allow

8. Salva il Trigger.
9. Ripeti questo processo per le restanti categorie di cookie.
10. Applica i Trigger ai Tag come firing trigger.

Nota: se un tag è bloccato e poi consentito, si attiverà senza bisogno di ricaricare la pagina perché è in ascolto di Pandectes_Consent_Update. Se prima era consentito e poi bloccato, il tag verrebbe bloccato nei successivi caricamenti di pagina.

Creare Exception Trigger

Puoi anche configurare un exception trigger per attivare lo script se una categoria di cookie non è consentita.

Ti conviene usare un exception trigger solo se hai già un diverso firing trigger impostato sul tuo tag.

Ad esempio, imposta un trigger che si attivi quando Pandectes_Consent_Update non consente C0002 (dove C0002 è l'id della categoria performance). Applica questo trigger di blocco come eccezione ai tag di questo gruppo.

1. Seleziona la scheda Triggers dal menu principale. Appare la schermata Triggers.
2. Premi New. Appare la schermata Trigger Configuration.
3. Crea un nuovo trigger e assegnagli un nome appropriato, ad esempio Pandectes Performance Blocked.
4. Premi Trigger Configuration e imposta il Trigger type su Custom Event.
5. Imposta Event name su Pandectes_Consent_Update.
6. Seleziona Some Custom Events e impostalo in modo che si attivi quando è vera la seguente condizione:

Pandectes C0001 equals deny

7. Salva il Trigger.
8. Ripeti questo processo per le restanti categorie di cookie.
9. Applica i Trigger ai Tag come exception trigger.

Aggiungere i trigger ai tag

1. Nel menu di navigazione principale di Google Tag Manager, seleziona Tags.
2. Seleziona un tag a cui applicare il Trigger della categoria di cookie Pandectes appropriato.
3. Applica il Firing Trigger o l'Exception Trigger appropriato che hai creato.
4. Fai clic sul pulsante Save.

Aggiornato il: 20/10/2026