Configurazione

Questo documento elenca tutti i campi di configurazione di Google Analytics.

allow_google_signals

Per disattivare le funzionalità pubblicitarie basate su identificatori pubblicitari di terze parti, 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);

Impostare per un singolo stream

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

allow_ad_personalization_signals

Imposta il valore 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);

Impostare 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');

Imposta 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');

Impostare 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');

Impostare 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 prodotti 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');

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

Nome campo Tipo Valore predefinito
campaign_source string undefined

Esempio

Imposta a livello globale

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

Impostare per un singolo stream

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

Utilizzato per la ricerca a pagamento. Utilizza 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');

Impostare per un singolo stream

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

campagna

Un oggetto contenente tutti i valori della campagna che possono essere impostati.

L'oggetto campaign viene fornito per supportare le implementazioni precedenti e non è consigliato per la maggior parte dei casi. Devi utilizzare invece 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'
});

Impostare 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 archiviato 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

Imposta a livello globale

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

Impostare 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');

Imposta per un singolo stream

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

Specifica il dominio utilizzato per memorizzare il cookie di Analytics.

Imposta il valore '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 utilizzerà example.com per il dominio e https://subdomain.example.com utilizzerà anch'esso example.com per il dominio.

Nome campo Tipo Valore predefinito
cookie_domain string 'auto'

Imposta a livello globale

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

Impostare per un singolo stream

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 attuale 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 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

Imposta a livello globale

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

Imposta per un singolo stream

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

Imposta a livello globale

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

Impostare per un singolo stream

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 '/'

Imposta a livello globale

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

Impostare per un singolo stream

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

Imposta a livello globale

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

Impostare per un singolo stream

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

Quando 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 lo stesso browser ogni cinque giorni, verrà aggiornata a ogni visita e di fatto non scadrà mai.

Se l'impostazione è 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

Imposta a livello globale

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

Impostare per un singolo stream

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

ignore_referrer

Imposta 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 falso

Esempio

Imposta a livello globale

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

Impostare per un singolo stream

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

language

Specifica la preferenza di lingua dell'utente. Il valore predefinito è il valore 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');

Impostare per un singolo stream

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

page_location

Specifica l'URL completo della pagina. Il valore predefinito è il valore 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');

Imposta 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 è il valore 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');

Imposta 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 è il valore 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');

Impostare per un singolo stream

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

send_page_view

Imposta su false per impedire allo snippet predefinito di inviare una visualizzazione di pagina.

Nome campo Tipo Valore predefinito
send_page_view boolean true

Esempio

Imposta a livello globale

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

Imposta 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 dal 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');

Impostare 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 o dall'utente della libreria. 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');

Impostare per un singolo stream

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

user_properties

Le proprietà utente sono attributi che possono essere utilizzati per descrivere segmenti della 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 property name=24
property value=36

Esempio

Imposta a livello globale

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

Impostare per un singolo stream

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