Cookie e identificazione degli utenti con gtag.js

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

Nota: puoi fare riferimento alla guida sull'utilizzo dei cookie per informazioni dettagliate su come gtag.js utilizza i cookie.

Configura le impostazioni del campo cookie

La seguente tabella mostra i valori predefiniti dei campi dei cookie 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 è abilitata in gtag.js. Se questa opzione è abilitata, gtag.js imposterà i cookie sul dominio di livello più alto 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 l'esecuzione di un server a livello locale (ad esempio localhost), imposta automaticamente cookie_domain su 'none', portando gtag.js a impostare i cookie utilizzando il dominio completo dalla posizione del documento.

Per disattivare la configurazione automatica del dominio dei cookie, aggiorna config per la proprietà per 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 tra 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 dominio è one.two.three.root.com, puoi configurare il cookie da impostare su root.com, ma non su someotherdomain.com. L'impostazione di un dominio dei cookie errato comporterà l'invio di hit a Google Analytics.

Prefisso del cookie

Per evitare conflitti con altri cookie, potrebbe essere necessario modificare il prefisso dei cookie, che viene anteposto ai cookie impostati da gtag.js. Ad esempio, il nome predefinito del cookie ID utilizzato da Google Analytics è _ga. Con questo codice, il cookie verrà denominato example_ga:

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

Attenzione: se un sito taggato con gtag.js o Google Analytics viene modificato dopo che gli utenti hanno visitato il sito, i visitatori verranno visualizzati come nuovi visitatori di gtag.js e Google Analytics, poiché il contesto memorizzato nei cookie senza prefisso andrà perso. Per questo motivo, se vuoi utilizzare un prefisso di cookie, ti consigliamo di utilizzarlo fin dalla prima interazione del sito.

Scadenza cookie

A ogni caricamento pagina, la scadenza dei cookie viene aggiornata sul valore corrente più il valore del campo cookie_expires. Questo significa che se cookie_expires è impostato su una settimana e un utente visita il sito con lo stesso browser entro 5 giorni, il cookie sarà disponibile per un'altra settimana e verrà visualizzato come lo stesso visitatore in Google Analytics. Se invece lo stesso utente ha visitato il sito dopo la scadenza del cookie originale, verrà creato un nuovo cookie 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 il cookie in modo che scada troppo velocemente, il conteggio degli utenti verrà aumentato in modo artificioso e la qualità della misurazione verrà ridotta.

Aggiornamento cookie

Quando cookie_update è impostato su true (valore predefinito), gtag.js aggiorna i cookie a ogni caricamento pagina. Questa operazione aggiorna la scadenza del cookie da impostare relativa alla visita più recente al sito. Ad esempio, se la scadenza dei cookie è impostata su una settimana e un utente visita il sito con lo stesso browser ogni cinque giorni, la scadenza dei cookie viene aggiornata a ogni visita e, di conseguenza, non scade mai.

Se imposti false, i cookie non vengono aggiornati a ogni caricamento pagina. Questo ha effetto sulla scadenza dei cookie rispetto alla prima volta che un utente ha visitato il sito.

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

Flag per cookie

Consente di aggiungere ulteriori flag al cookie quando impostato. I flag devono essere separati da punto e virgola.

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

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

Imposta ID utente

Uno User-ID è una stringa ID univoca, permanente e non personale che rappresenta un utente. Consente di analizzare gruppi di sessioni su più dispositivi. Per conoscere il motivo per cui dovresti implementare lo User-ID, consulta Vantaggi dell'utilizzo della funzionalità User-ID.

Per implementare lo User-ID con gtag.js, aggiorna config per la 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 i cookie fino a quando non viene fornito il consenso dall'utente. Per scoprire di più, consulta Modificare il comportamento dei tag in base al consenso