Cookie e identificazione degli utenti con gtag.js

gtag.js utilizza i cookie per identificare gli utenti unici tra le sessioni di navigazione. In questa pagina viene spiegato come personalizzare le impostazioni dei cookie.

Nota: per informazioni dettagliate su come gtag.js utilizza i cookie, consulta la guida sull'utilizzo dei cookie.

Configura le impostazioni del campo relativo ai cookie

La tabella seguente mostra i valori dei campi cookie predefiniti utilizzati da gtag.js:

Nome campo	Tipo di valore	Valore predefinito
cookie_domain	string	auto
cookie_expires	integer	63072000 (due anni, in secondi)
cookie_prefix	string	_ga
cookie_update	boolean	true
cookie_flags	string

Per modificare uno di questi valori, aggiorna il config per la tua proprietà per specificarli nell'elenco dei parametri. Ad esempio:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

Configurazione del dominio dei cookie

Per impostazione predefinita, la configurazione automatica del dominio dei cookie in gtag.js è abilitata. Se questa opzione è abilitata, gtag.js imposta i cookie sul dominio di livello più elevato possibile. Ad esempio, se l'indirizzo del tuo sito web è blog.example.com, gtag.js imposterà i cookie sul dominio example.com. Se gtag.js rileva che esegui un server in locale (ad es. localhost), imposta automaticamente cookie_domain su 'none', in modo che gtag.js imposti i cookie utilizzando il dominio completo dalla posizione del documento.

Per disattivare la configurazione automatica del dominio dei cookie, aggiorna il config per la tua proprietà in modo da specificare un valore per il parametro cookie_domain:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

Nota: quando utilizzi la configurazione automatica del dominio dei cookie, l'attività verrà misurata nei sottodomini senza alcuna configurazione aggiuntiva.

Attenzione: cookie_domain deve essere un predecessore del dominio corrente, altrimenti il cookie non verrà impostato. Ad esempio, se il tuo dominio è one.two.three.root.com, puoi configurare il cookie in modo che venga impostato su root.com, ma non su someotherdomain.com. L'impostazione di un dominio dei cookie errato non comporterà l'invio di hit a Google Analytics.

Prefisso cookie

Per evitare conflitti con altri cookie, potrebbe essere necessario modificare il prefisso del cookie, che verrà anteposto ai cookie impostati da gtag.js. Ad esempio, il nome predefinito del cookie ID utilizzato da Google Analytics è _ga. Questo codice farà invece sì che il cookie venga nominato example_ga:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

Attenzione: se un sito con tag è gtag.js o Google Analytics e cookie_prefix viene modificato una volta che gli utenti lo hanno visitato, questi visitatori appariranno come nuovi visitatori di gtag.js e Google Analytics, perché il contesto memorizzato nei cookie senza prefisso andrà perso. Per questo motivo, se vuoi utilizzare un prefisso dei cookie, ti consigliamo di utilizzarlo la prima volta che il sito viene codificato.

Scadenza cookie

A ogni caricamento pagina, la scadenza dei cookie viene aggiornata in modo da corrispondere all'ora attuale più il valore del campo cookie_expires. Ciò significa che se cookie_expires è impostato su una settimana e un utente visita utilizzando lo stesso browser entro cinque giorni, il cookie sarà disponibile per un'altra settimana e verrà visualizzato come stesso visitatore in Google Analytics. Se invece lo stesso utente ha visitato il sito dopo la scadenza del cookie originale, ne verrà creato uno nuovo e la prima e la seconda visita verranno visualizzate come provenienti da visitatori distinti in Google Analytics.

Se imposti il valore cookie_expires su 0 (zero) secondi, il cookie si trasforma in un cookie basato sulla sessione e scade al termine della sessione del browser corrente.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

Attenzione: se imposti una scadenza del cookie troppo ravvicinata, il numero di utenti risulterà aumentato e la qualità della misurazione peggiorerà.

Aggiornamento cookie

Se cookie_update è impostato su true (il valore predefinito), gtag.js aggiornerà i cookie a ogni caricamento pagina. In questo modo la scadenza dei cookie viene aggiornata in base alla visita più recente al sito. Ad esempio, se la scadenza dei cookie è impostata su una settimana e un utente visita utilizzando lo stesso browser ogni cinque giorni, la scadenza dei cookie viene aggiornata a ogni visita e quindi non scadrà mai.

Se il criterio viene impostato su false, i cookie non vengono aggiornati a ogni caricamento pagina. Per questo motivo, la scadenza dei cookie si basa sulla prima visita di un utente al sito.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

Flag per cookie

Se impostato, aggiunge ulteriori flag al cookie. I flag devono essere separati da un punto e virgola.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

Attenzione: l'impostazione di samesite su None e l'omissione del flag Secure o la pubblicazione sul sito tramite HTTP avrà un impatto negativo sulla misurazione.

Impostare lo User-ID

Uno User-ID è una stringa ID univoca e permanente che rappresenta un utente, ma non ne consente l'identificazione personale. Consente di analizzare gruppi di sessioni su più dispositivi. Per informazioni sui motivi per cui è consigliabile implementare lo User-ID, consulta Vantaggi dell'utilizzo della funzionalità User-ID.

Per implementare lo User-ID con gtag.js, aggiorna il config della tua proprietà per impostare lo User-ID:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

Modificare il comportamento dei tag in base al consenso

Puoi configurare gtag.js in modo che non legga o scriva cookie fino a quando l'utente non ha fornito il consenso. Per scoprire di più, consulta Modificare il comportamento dei tag in base al consenso.