Questa pagina è stata tradotta dall'API Cloud Translation.

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

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:

campaign_id
campaign_source
campaign_medium
campaign_name
campaign_term
campaign_content

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