Configurazione

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

Impostazione globale

gtag('set', 'allow_google_signals', true);

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

Imposta su false per disattivare le funzionalità di personalizzazione della pubblicità.

Nome campo Tipo Valore predefinito
allow_ad_personalization_signals boolean true

Esempio

Impostazione globale

gtag('set', 'allow_ad_personalization_signals', true);

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'campaign_content', 'logolink');

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'campaign_id', 'abc.123');

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'campaign_medium', 'cpc');

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'campaign_name', 'spring_sale');

Impostazione per streaming singolo

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 fonte.

Nome campo Tipo Valore predefinito
campaign_source string undefined

Esempio

Impostazione globale

gtag('set', 'campaign_source', 'google');

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'campaign_term', 'running+shoes');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

campagna

Un oggetto che contiene tutti i valori che è possibile impostare per la campagna.

L'oggetto campaign viene fornito per supportare le implementazioni precedenti 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

Impostazione globale

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

Impostazione per streaming singolo

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 proprietario di Analytics con una scadenza di due anni.

Nome campo Tipo Valore predefinito
client_id string Un valore generato in modo casuale per ciascun utente.

Esempio

Impostazione globale

gtag('set', 'client_id', 'aaa.bbb');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

Nome campo Tipo Valore predefinito
content_group string

Esempio

Impostazione globale

gtag('set', 'content_group', '/news/sports');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

Specifica il dominio utilizzato per memorizzare il cookie di Analytics.

Imposta il cookie su 'none' per impostare il cookie senza specificare un dominio.

Imposta il cookie su '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 utilizzerà 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'

Impostazione globale

gtag('set', 'cookie_domain', 'example.com');

Impostazione per streaming singolo

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

Ogni volta che viene inviato un hit a Google Analytics, la scadenza del 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 scadrà 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

Impostazione globale

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

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

Impostazione globale

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

Impostazione per streaming singolo

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

Specifica il percorso secondario utilizzato per memorizzare il cookie di Analytics.

Nome campo Tipo Valore predefinito
cookie_path string '/'

Impostazione globale

gtag('set', 'cookie_path', '/example_path');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

Specifica un prefisso da anteporre ai nomi dei cookie di Analytics.

Nome campo Tipo Valore predefinito
cookie_prefix string

Impostazione globale

gtag('set', 'cookie_prefix', 'prefix');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

Se cookie_update è impostato su true, 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 il sito utilizzando lo stesso browser ogni cinque giorni, la scadenza dei cookie viene aggiornata a ogni visita e non scade mai.

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

Nome campo Tipo Valore predefinito
cookie_update boolean true

Impostazione globale

gtag('set', 'cookie_update', true);

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'ignore_referrer', true);

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'ignore_referrer': true
});

language

Specifica la preferenza di lingua dell'utente. Il valore predefinito corrisponde al valore navigator.language dell'utente.

Nome campo Tipo Valore predefinito
language string Il valore predefinito sarà navigator.language

Esempio

Impostazione globale

gtag('set', 'language', 'en-us');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

Specifica l'URL completo della pagina. Il valore predefinito corrisponde al valore document.location dell'utente.

Nome campo Tipo Valore predefinito Character Limit
page_location string Il valore predefinito è document.location 1000

Esempio

Impostazione globale

gtag('set', 'page_location', 'https://example.com/page1');

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'page_referrer', 'https://example.com');

Impostazione per streaming singolo

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

Impostazione globale

gtag('set', 'page_title', 'Settings');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

Impostalo su false per impedire allo snippet predefinito di inviare un page_view.

Nome campo Tipo Valore predefinito
send_page_view boolean true

Esempio

Impostazione globale

gtag('set', 'send_page_view', false);

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

Specifica la risoluzione dello schermo. Devono essere due numeri interi positivi separati da x. Ad esempio, per una schermata di 800 x 600 px, 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

Impostazione globale

gtag('set', 'screen_resolution', '800x600');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

Specifica un identificatore noto per un utente fornito dal proprietario del sito/utente della raccolta. 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

Impostazione globale

gtag('set', 'user_id', 'id');

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

Le proprietà utente sono attributi che possono essere utilizzati per descrivere segmenti della base utenti, ad esempio le preferenze relative alla 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

Impostazione globale

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

Impostazione per streaming singolo

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});