> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pandectes.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](/it/article/pandectes-custom-event-1662w44/) tramite la Data Layer Variable.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/a/5/a/1a5af239e847cf00/image_urf7g0.png =800x113)

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. 

| Puoi anche rinominare questa proprietà con qualsiasi proprietà personalizzata che hai utilizzato. Questa è disponibile come opzione nel modulo di integrazione GTM della nostra app.

### Guida video


${youtube}[Integration with Google Tag Manager](BPu8xsH3lmc)

### 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](/it/article/pandectes-custom-event-1662w44/), 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](/it/article/pandectes-custom-event-1662w44/) (ad esempio, per la categoria *Functionality* puoi inserire **pandectes_categories.C0001**).

    ![](https://storage.crisp.chat/users/helpdesk/website/a9d7ec56f6baf800/dfc98d3e-716c-44e6-a1e8-985028_9evj16.png =1000x341)

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](/it/article/usare-l-integrazione-google-consent-mode-1vrm719/) 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
```

    ![](https://storage.crisp.chat/users/helpdesk/website/8de68f7bcb67b800/ffe2428f-7e0a-417e-8c1f-a8c733_a0ccz.png =1000x516)

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
```

    ![](https://storage.crisp.chat/users/helpdesk/website/5e3631a87e0ad400/98c395a5-729c-4a6b-9506-0763ff_1th1t7j.png =1000x512)

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