--- title: Integrazione GTM (Consent Mode) slug: it-pubtech-cmp/integrazione-gtm-consent-mode docTags: createdAt: 2023-06-05T09:15:43.000Z --- Google Tag Manager offre diverse funzionalità che interagiscono tra loro per aiutarti a gestire il comportamento dei tag in risposta alle impostazioni del [consenso](https://support.google.com/analytics/answer/9976101). :::hint{type="info"} **Lo scopo di questa documentazione è fornire una panoramica dettagliata di ciascuna impostazione della Modalità di Consenso di Google, seguendo scrupolosamente le spiegazioni e le linee guida fornite da Google. Ciò non implica che le impostazioni della Modalità di consenso siano progettate per soddisfare o indirizzare particolari requisiti normativi.** Nel seguente link è disponibile la spiegazione completa di come funziona il consent mode di Google: [https://support.google.com/google-ads/answer/10000067](https://support.google.com/google-ads/answer/10000067) ::: La seguente guida offre gli step da seguire per l'integrazione e utilizzo del template Pubconsent per Google Tag Manger. Questo template è stato realizzato con lo scopo di integrare PubConsent con GTM, questo significa che lo script di PubConsent dovrà comunque essere integrato nelle pagine. :::hint{type="info"} Questa documentazione è valida per entrambi i tipi di CMP che offriamo. ::: :::hint{type="warning"} Prima di eseguire questa guida assicurati che il codice di integrazione PubConsent disponibile nel configuratore sia presente nella pagina. ::: Assicurati di letto anche la documentazione Google al seguente link relativa a Tag Manager: [https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced](https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced) ## Importazione del template Esegui il login in Google Tag Manager ed apri la 'Workspace' tab.. Clicca su 'Search Gallery' nella sezione Templates di Google Tag Manager. ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/QJrbUC-oAEoBKnyrRzUwm_screenshot-2023-06-05-at-114409.png) Ora cerca "Pubtech CMP" e successivamente il tasto "Add to workspace". ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/KdOtIwJYkpEqhKLmhc7AR_screenshot-2024-03-06-at-102002.png) ## Utilizzo del template Esegui il login in Google Tag Manager ed apri la 'Workspace' tab. Crea un tag cliccando il tasto 'New': ::Image[]{src="https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/lAcNtUqOf9wHyevJMoG6L_workspacetab.png" size="100" width="1684" height="526" position="center" showCaption="false" indent="2"} ::Image[]{src="https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/fIo4I5p88azD4WMdVX0y7_newtag.png" size="100" width="1752" height="680" isUploading="false" darkWidth="1752" darkHeight="680" showCaption="false" indent="2"} Apri la Tag Configuration e seleziona il Pubtech CMP template importato precedentemente: ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/OrU9NwdPSm8361rv8lYix_tagconfiguration.png) ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/x4smkbRd5-xpCeV6MBDK3_screenshot-2024-03-06-at-102157.png) Qui puoi configurare il nostro template Pubtech CMP: ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/S3EvjVgwzCy5Iibj_3skD_pubtechcmp-config.png) Prima di procedere alla configurazione dei valori predefiniti dall'integrazione di Google Tag Manager per i consensi possiamo configurare i parametri **Ads Data Redaction** e **urlPassThrough**. Attivando l'opzione [Ads Data Redaction](https://developers.google.com/tag-platform/devguides/consent?hl=it#redact_ads_data) quando **ad\_storage** è **denied**, gli identificatori dei clic sugli annunci inviati nelle richieste di rete dai tag Google Ads e Floodlight verranno oscurati. Le richieste di rete verranno inviate anche tramite un dominio senza cookie. L'opzione [urlPassThrough](https://developers.google.com/tag-platform/devguides/consent?hl=it#passing_ad_click_client_id_and_session_id_information_in_urls) migliora la qualità della misurazione dei clic sugli annunci quando **ad\_storage** è **denied** inviando i dati direttamente negli URL. :::hint{type="info"} Tramite il template di Google Tag Manager (GTM) è possibile iniettare la vostra CMP indicando l'id della tua CMP che trovate nella tab del codice di integrazione. Tuttavia, consigliamo vivamente di inserire gli script direttamente nella sezione del vostro sito. Questa modalità garantisce performance superiori e una migliore esperienza utente. ::: :::Iframe{code=""} ::: Cliccando su 'Add Row' puoi specificare i parametri di default (di seguito la spiegazione in dettaglio): ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/EAV8LclGKXjiDVXILiGMX_pubtechcmp-configpanel.png) Qui puoi configurare la regione (per impostazione predefinita lasciala vuota), i tipi di consenso concesso e i tipi di consenso negato. Queste sono le configurazioni predefinite quando il GTM avvia la sua esecuzione sulla pagina. In base alle tue preferenze puoi scrivere le tipologie di consenso concesso o negato. Qui l'elenco completo dei tipi di consenso: 1. ad\_storage 2. ad\_user\_data 3. ad\_personalization 4. analytics\_storage 5. functionality\_storage 6. personalization\_storage 7. security\_storage Aggiungi le configurazioni e fai clic sul pulsante "Add": :::hint{type="info"} Nell'esempio sottostante abbiamo configurato i campi in questo modo: - Region: - Granted Consent Types: ad\_storage,analytics\_storage,personalization\_storage,security\_storage - Denied Consent Types: functionality\_storage **Nel caso vogliate specificare comportamenti diversi per regione è necessario aggiungere anche la configurazione di default con la Region vuota.** ::: ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/E68zCFSFkG39Uounpssgh_pubtechcmp-configpanelexample.png) Ora devi scegliere il Trigger per questo Tag: ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/FNEG7BKPMKA-q4usmaxn8_triggering.png) Qui scegli il trigger "Consent Initialization - All Pages": ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/8RC2dJ7HDuDxvR35-zav__trigger-allpages.png) Cambia il nome in alto a sinistra e fai clic sul pulsante "Save". A questo punto hai configurato il tag in modo corretto. ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/C6ZDd7YUvhAITdXnefgaf_screenshot-2023-11-16-at-113344.png) Dopo aver eseguito tutta la procedura si può procedere al normale test effettivo utilizzando la GTM preview. :::hint{type="info"} Vi lasciamo qui i link alla documentazione Google: [https://support.google.com/analytics/answer/9976101](https://support.google.com/analytics/answer/9976101?hl=it) [https://support.google.com/tagmanager/answer/10718549](https://support.google.com/tagmanager/answer/10718549) ::: :::hint{type="warning"} Per avere una paronamica del consenso vi consigliamo di abilitare la panoramica del consenso all'interno di Tag Manager: All'interno di Tag Manager "Amministrazione" -> "Contenitore" -> "Impostazioni contenitore" -> "Attiva panoramica del consenso" ::: ## Mapping dei consensi (Google Consent Mode) Per conoscere a quali scelte dell'utente corrisponde il consent type di Google qui di seguito vi forniamo il relativo mapping: ::::Tabs :::Tab{title="Cmp Type: GDPR TCF"} - ad\_storage -> TCF Purpose 1 - ad\_user\_data -> TCF Purpose 1 e 7 - ad\_personalization -> TCF Purpose 3 e 4 - analytics\_storage -> Cookie di misurazione - functionality\_storage -> Cookie di funzionalità - personalization\_storage -> Cookie Esperienza Utente - security\_storage -> Cookie di funzionalità ::: :::Tab{title="CMP Type: Google Consent Mode"} Il mapping dei consensi è 1 a 1 ovvero nel pannello di consenso si vedranno elencati i tipi di consensi di Google Consent Mode senza nessuna maschera. ::: :::: ## Trigger al consenso Nel caso abbiate bisogno di un trigger che venga eseguito quando c'è un consenso la nostra integrazione invia un evento a GTM chiamato `__pubtech_queue_on_consent` Grazie a questo evento è possibile creare un trigger in GTM per essere utilizzato in base alle esigenze di esecuzione dei vostri Tag GTM. :::hint{type="warning"} L'evento che vi mostriamo di seguito viene eseguito: \- al rilascio di un consenso da parte dell'utente \- al cambio di un consenso da parte dell'utente \- all'inizio della pagina se il consenso è già stato preso precedentemente La gestione o rimozione di eventuali tag triggerati nel corso della pagina sono a responsabilità di chi implementa i tag. ::: Il trigger da creare nella sezione trigger di GTM è un `Custom Event` aggiungendo il nome dell'evento: `__pubtech_queue_on_consent` ![](https://api.archbee.com/api/optimize/tSSPsDx4e0ELF2dn1YcSR/Sy5Npe5YAOg48si6V6QPY_screenshot-2023-11-16-at-121946.png) Una volta salvato il trigger, potete utilizzarlo come trigger dei vostri tag. Ora potete utilizzare questo trigger direttamente o in combinazione di altri trigger in base alle vostre esigenze. Ci teniamo a dirvi che questo Custom Event è stato aggiunto poichè tramite i Trigger di Google Tag Manager abbiamo notato che non è possibile eseguire dei tag nel momento in cui l'utente clicca per dare un consenso (che sia un rifiuto o un accetta tutto) poichè può accadere in un tempo sconosciuto, mentre una volta ottenuto il consenso la CMP si occuperà di aggiornare lo stato di consenso su GTM nel più breve tempo possibile. :::hint{type="info"} Qui il link alla documentazione Google per implementazioni e configurazioni: [https://support.google.com/analytics/answer/9976101?hl=it](https://support.google.com/analytics/answer/9976101?hl=it) :::