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.
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'
});
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'
});
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
});
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'
});
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.