Questo documento elenca tutti i campi di configurazione per GA4.
allow_google_signals
Per disattivare tutte le funzionalità pubblicitarie, imposta allow_google_signals
su false
.
Nome campo | Tipo | Valore predefinito |
---|---|---|
allow_google_signals |
boolean |
true |
Esempio
Imposta a livello globale
gtag('set', 'allow_google_signals', true);
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'allow_google_signals': true
});
allow_ad_personalization_signals
Imposta false
per disattivare le funzionalità di personalizzazione della pubblicità.
Nome campo | Tipo | Valore predefinito |
---|---|---|
allow_ad_personalization_signals |
boolean |
true |
Esempio
Imposta a livello globale
gtag('set', 'allow_ad_personalization_signals', true);
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'allow_ad_personalization_signals': true
});
campaign_content
Utilizzato per il test A/B e gli annunci con targeting basato sui contenuti. Utilizza campaign_content
per differenziare gli annunci o i link che puntano allo stesso URL.
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign_content |
string |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign_content', 'logolink');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign_content': 'logolink'
});
campaign_id
Utilizzato per identificare la campagna a cui si riferisce il referral. Utilizza campaign_id
per identificare una campagna specifica.
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign_id |
string |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign_id', 'abc.123');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign_id': 'abc.123'
});
campaign_medium
Utilizza campaign_medium
per identificare un mezzo, ad esempio email o costo per clic.
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign_medium |
string |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign_medium', 'cpc');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign_medium': 'cpc'
});
campaign_name
Utilizzato per l'analisi delle parole chiave. Utilizza campaign_name
per identificare una promozione
di un prodotto o una campagna strategica specifica.
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign_name |
string |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign_name', 'spring_sale');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign_name': 'spring_sale'
});
campaign_source
Utilizza campaign_source
per identificare un motore di ricerca, il nome di una newsletter o un'altra sorgente.
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign_source |
string |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign_source', 'google');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign_source': 'google'
});
campaign_term
Utilizzato per la ricerca a pagamento. Usa campaign_term
per annotare le parole chiave per questo annuncio.
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign_term |
string |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign_term', 'running+shoes');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign_term': 'running+shoes'
});
campagna
Un oggetto contenente tutti i valori che è possibile impostare per la campagna.
L'oggetto campaign
viene fornito per supportare le implementazioni legacy e non è consigliato nella maggior parte dei casi. Devi invece utilizzare la
versione con prefisso campaign
di ogni campo:
Nome campo | Tipo | Valore predefinito |
---|---|---|
campaign |
object |
undefined |
Esempio
Imposta a livello globale
gtag('set', 'campaign', {
'id': 'abc.123',
'source': 'google',
'medium': 'cpc',
'name': 'spring_sale',
'term': 'running+shoes',
'content': 'logolink'
});
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'campaign': {
'id': 'abc.123',
'source': 'google',
'medium': 'cpc',
'name': 'spring_sale',
'term': 'running+shoes',
'content': 'logolink'
}
});
client_id
Identifica con assegnazione di pseudonimi un'istanza del browser. Per impostazione predefinita, questo valore viene memorizzato come parte del cookie di Analytics proprietario con una scadenza di due anni.
Nome campo | Tipo | Valore predefinito |
---|---|---|
client_id |
string |
Un valore generato in modo casuale per ciascun utente. |
Esempio
Imposta a livello globale
gtag('set', 'client_id', 'aaa.bbb');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'client_id': 'aaa.bbb'
});
content_group
Nome campo | Tipo | Valore predefinito |
---|---|---|
content_group |
string |
Esempio
Imposta a livello globale
gtag('set', 'content_group', '/news/sports');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'content_group': '/news/sports'
});
cookie_domain
Specifica il dominio utilizzato per memorizzare il cookie di Analytics.
Imposta il cookie su 'none'
per impostare il cookie senza specificare un dominio.
Imposta 'auto'
(il valore predefinito) per impostare il cookie sul dominio di primo livello più un sottodominio (eTLD +1). Ad esempio, se cookie_domain
è impostato su 'auto'
https://example.com
userà example.com
per il dominio e
https://subdomain.example.com
anche example.com
per il dominio.
Nome campo | Tipo | Valore predefinito |
---|---|---|
cookie_domain |
string |
'auto' |
Esempio
Imposta a livello globale
gtag('set', 'cookie_domain', 'example.com');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'cookie_domain': 'example.com'
});
cookie_expires
Ogni volta che viene inviato un hit a Google Analytics, la scadenza dei cookie viene aggiornata in modo da corrispondere all'ora corrente più il valore del campo cookie_expires
.
Ciò significa che se utilizzi il valore predefinito di due anni (63072000
secondi) e un utente visita il tuo sito ogni mese, il suo cookie non scade mai.
Se imposti il tempo di 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.
Nome campo | Tipo | Valore predefinito |
---|---|---|
cookie_expires |
number |
63072000 |
Esempio
Imposta a livello globale
gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});
cookie_flags
Se impostato, aggiunge ulteriori flag al cookie. I flag devono essere separati da un punto e virgola. Consulta Scrivere un nuovo cookie per alcuni esempi di flag da impostare.
Nome campo | Tipo | Valore predefinito |
---|---|---|
cookie_flags |
string |
Esempio
Imposta a livello globale
gtag('set', 'cookie_flags', 'SameSite=None;Secure');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'cookie_flags': 'SameSite=None;Secure'
});
cookie_path
Specifica il percorso secondario utilizzato per memorizzare il cookie di Analytics.
Nome campo | Tipo | Valore predefinito |
---|---|---|
cookie_path |
string |
'/' |
Esempio
Imposta a livello globale
gtag('set', 'cookie_path', '/example_path');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'cookie_path': '/example_path'
});
cookie_prefix
Specifica un prefisso da anteporre ai nomi dei cookie di Analytics.
Nome campo | Tipo | Valore predefinito |
---|---|---|
cookie_prefix |
string |
Esempio
Imposta a livello globale
gtag('set', 'cookie_prefix', 'prefix');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'cookie_prefix': 'prefix'
});
cookie_update
Se cookie_update
è impostato su true
, gtag.js aggiorna 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 del cookie viene aggiornata a ogni visita e 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.
Nome campo | Tipo | Valore predefinito |
---|---|---|
cookie_update |
boolean |
true |
Esempio
Imposta a livello globale
gtag('set', 'cookie_update', true);
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'cookie_update': true
});
ignore_referrer
Impostalo su true
per indicare ad Analytics che il referrer non deve essere visualizzato
come sorgente di traffico.
Scopri quando utilizzare questo campo
Nome campo | Tipo | Valore predefinito |
---|---|---|
ignore_referrer |
boolean |
false |
Esempio
Imposta a livello globale
gtag('set', 'ignore_referrer', true);
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'ignore_referrer': true
});
language
Specifica la preferenza di lingua dell'utente. Il valore predefinito è
navigator.language
dell'utente.
Nome campo | Tipo | Valore predefinito |
---|---|---|
language |
string |
Il valore predefinito sarà navigator.language |
Esempio
Imposta a livello globale
gtag('set', 'language', 'en-us');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'language': 'en-us'
});
page_location
Specifica l'URL completo della pagina. Il valore predefinito è
document.location
dell'utente.
Nome campo | Tipo | Valore predefinito | Character Limit |
---|---|---|---|
page_location |
string |
Il valore predefinito è document.location |
1000 |
Esempio
Imposta a livello globale
gtag('set', 'page_location', 'https://example.com/page1');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'page_location': 'https://example.com/page1'
});
page_referrer
Specifica quale sorgente di referral ha indirizzato il traffico verso una pagina. Questo valore viene utilizzato anche
per calcolare la sorgente di traffico. Il formato di questo valore è un URL.
Il valore predefinito è document.referrer
dell'utente.
Nome campo | Tipo | Valore predefinito | Character Limit |
---|---|---|---|
page_referrer |
string |
Il valore predefinito sarà document.referrer |
420 |
Esempio
Imposta a livello globale
gtag('set', 'page_referrer', 'https://example.com');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'page_referrer': 'https://example.com'
});
page_title
Il titolo della pagina o del documento. Il valore predefinito è document.title
dell'utente.
Nome campo | Tipo | Valore predefinito | Character Limit |
---|---|---|---|
page_title |
string |
Il valore predefinito sarà document.title |
300 |
Esempio
Imposta a livello globale
gtag('set', 'page_title', 'Settings');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'page_title': 'Settings'
});
send_page_view
Imposta il valore false per impedire allo snippet predefinito di inviare un parametro page_view.
Nome campo | Tipo | Valore predefinito |
---|---|---|
send_page_view |
boolean |
true |
Esempio
Imposta a livello globale
gtag('set', 'send_page_view', false);
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'send_page_view': false
});
screen_resolution
Specifica la risoluzione dello schermo. Devono essere due numeri interi positivi separati da un x
. Ad esempio, per una schermata di 800 x 600 pixel, il valore sarà 800x600
. Viene calcolato in base al valore window.screen
dell'utente.
Nome campo | Tipo | Valore predefinito |
---|---|---|
screen_resolution |
string |
Il valore predefinito verrà calcolato da window.screen
|
Esempio
Imposta a livello globale
gtag('set', 'screen_resolution', '800x600');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'screen_resolution': '800x600'
});
user_id
Specifica un identificatore noto per un utente fornito dal proprietario del sito/dall'utente della biblioteca. Non deve essere considerato PII (informazioni che consentono l'identificazione personale). Il valore non deve mai essere mantenuto nei cookie di Google Analytics o in altro spazio di archiviazione fornito da Analytics.
Nome campo | Tipo | Valore predefinito | Character Limit |
---|---|---|---|
user_id |
string |
256 |
Esempio
Imposta a livello globale
gtag('set', 'user_id', 'id');
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'user_id': 'id'
});
user_properties
Le proprietà utente sono attributi che possono essere utilizzati per descrivere i segmenti della tua base utenti, come la preferenza di lingua o la posizione geografica. Puoi impostare fino a 25 proprietà utente aggiuntive per progetto.
Nome campo | Tipo | Valore predefinito | Character Limit |
---|---|---|---|
user_properties |
object |
proprietà name=24 valore proprietà=36 |
Esempio
Imposta a livello globale
gtag('set', 'user_properties', {
'favorite_color': 'blue'
});
Impostazione per un singolo stream
gtag('config', 'STREAM_ID', {
'user_properties': {
'favorite_color': 'blue'
}
});