Informazioni sullo snippet gtag.js e sugli ID proprietà
Gli snippet gtag.js per una proprietà Universal Analytics e una proprietà Google Analytics 4 sono sostanzialmente uguali. Entrambi gli snippet hanno la seguente struttura:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Un ID proprietà A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Un ID proprietà A>');
08:
09: gtag('config', '<Un ID proprietà B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Un ID proprietà B>' });
14:
15: </script>
Riga 1: se hai implementato una proprietà Universal Analytics tramite gtag.js, è probabile che sul tuo sito sia già presente questa riga di codice. Al posto di <Un ID proprietà A>, vedrai "UA-" seguito da una serie di numeri. Se hai implementato gtag.js per Google Ads o per un altro prodotto Google Marketing Platform, sul tuo sito web potrebbe essere presente anche questa riga di codice, ma <Un ID proprietà A> inizierà con "AW-" o "DC-".
L'ID proprietà (o l'ID tag per le proprietà Google Analytics 4) indicato da <Un ID proprietà A> "controlla" questo snippet gtag.js. Questo è importante perché:
- Se la riga è già presente, non deve essere implementata una seconda volta. Dovrai solo aggiungere una riga "config" per specificare l'ID tag.
- L'ID proprietà su questa riga è il "controller" dello snippet gtag.js. Se un ID proprietà Universal Analytics ("UA-XXXXXXXX") controlla il tag, potrai utilizzare i tag del sito collegati per inviare i dati di misurazione a una proprietà Google Analytics 4, senza dover aggiungere un nuovo codice alla pagina.
Riga 7: la direttiva "config" di gtag consente la raccolta dati nella proprietà associata a <Un ID proprietà A>. Ad esempio, in una proprietà Google Analytics 4, se aggiungi questa direttiva con un ID tag, vengono inviati eventi page_view a tale proprietà.
L'ID proprietà può rappresentare la misurazione per diversi prodotti Google, tra cui una proprietà Universal Analytics ("UA-XXXXXXXX"), una proprietà Google Analytics 4 ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") o Floodlight ("DC" -XXXXXXXX).
Riga 11: la direttiva "event" di gtag invia un evento. Negli snippet in cui sono presenti più direttive "config" per più proprietà, l'evento verrà inviato a tutte le proprietà.
In questo esempio, il parametro "sign_up" è il nome dell'evento. L'ultimo parametro è un oggetto contenente un insieme di parametri evento. In questo caso, "method" è un parametro con valore "email".
Riga 13: in questo caso il parametro dell'evento è "send_to". Si tratta di un parametro speciale che invia l'evento associato a una proprietà specifica. In altre parole, questo evento verrà inviato solo alla proprietà indicata da <Un ID proprietà B>.
Il comando gtag config consente la misurazione di base.
- Per una proprietà Universal Analytics, il comando "config" con un ID proprietà Universal Analytics invia un hit visualizzazione di pagina.
- Per una proprietà Google Analytics 4, il comando "config" con un ID tag consente la raccolta di eventi page_view (come eventi raccolti automaticamente) quando viene caricato su una pagina.
Identificatori di proprietà
Il formato degli ID proprietà Universal Analytics è "UA-XXXXXXXX". Talvolta sono denominati ID monitoraggio. In questa guida, verranno definiti ID proprietà UA.
Gli stream di dati web delle proprietà Google Analytics 4 utilizzano un ID tag con formato "G-XXXXXXXX".
In alcuni esempi di codice e in determinata documentazione, potrebbero essere entrambi indicati come "TAG_ID".
Raccolta dati di base
Se attivi la raccolta dati di base per una proprietà Google Analytics 4, verrà raccolto quanto segue:
- Eventi page_view
- Eventi raccolti automaticamente
- Eventi di misurazione avanzata (se attivati nell'interfaccia utente)
Se la tua proprietà Universal Analytics esistente utilizza un'implementazione gtag.js, attiva la raccolta dati di base per la tua proprietà Google Analytics 4 come indicato di seguito:
- Opzione 1: aggiungi una nuova direttiva "config" con il relativo ID tag
OPPURE - Opzione 2: attiva i tag del sito collegati (se l'implementazione gtag.js esistente è idonea)
Indipendentemente dall'opzione scelta, la proprietà Universal Analytics esistente rimane invariata e continuerà a raccogliere dati.
Opzione 1: aggiungi una nuova direttiva "config"
Se sulla pagina esiste già il codice gtag.js, è sufficiente aggiungere un'ulteriore direttiva "config" con il relativo ID misurazione della proprietà Google Analytics 4. Nell'esempio riportato di seguito, la riga 8 è stata aggiunta a un'implementazione gtag.js esistente. Fa riferimento all'ID misurazione della proprietà Google Analytics 4 e determina l'invio degli eventi page_view alla proprietà Google Analytics 4. Inoltre, attiva gli eventi raccolti automaticamente e gli eventi di misurazione avanzata (se l'hai attivata) in tale proprietà Google Analytics 4.1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Un ID proprietà A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Un ID proprietà A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Opzione 2: attiva i tag del sito collegati
Puoi utilizzare un tag del sito collegato se:
- Lo snippet gtag.js esistente sulla pagina in cui vuoi misurare le interazioni utente è "controllato" da una proprietà Universal Analytics, ovvero l'ID a cui si fa riferimento in questa riga dello snippet gtag.js inizia con "UA-":
<script async src="https://www.googletagmanager.com/gtag/js?id=<Un ID proprietà A>"></script>
(I tag del sito collegati funzionano anche se lo snippet gtag.js esistente è controllato da una proprietà Google Analytics 4. Questa situazione si verifica tuttavia solo se è già stata implementata una proprietà Google Analytics 4.)
- E hai accesso amministrativo alla proprietà Universal Analytics a cui fa riferimento l'ID nello snippet.
Impostazioni di configurazione per gtag.js
Puoi configurare lo snippet gtag.js di base per controllare le impostazioni di raccolta dati, come l'anonimizzazione IP, le personalizzazioni dei cookie e Google Signals. A tale scopo, utilizza le direttive "config" o "set" in gtag.js.
Entrambe le proprietà Universal Analytics ("UA-XXXXXXXX") e Google Analytics 4 ("G-XXXXXXXX") supportano l'implementazione di queste impostazioni di configurazione tramite gtag.js. Tuttavia, esistono alcune differenze tra queste impostazioni a seconda che si tratti di proprietà Universal Analytics o proprietà Google Analytics 4.
- L'anonimizzazione IP è standardizzata su "true" e non è configurabile in una proprietà Google Analytics 4. Di conseguenza, l'indirizzo IP è automaticamente mascherato con l'evento standard nella proprietà Google Analytics 4 ("G-XXXXXXXX").
- Quando occorre applicare le impostazioni globali a tutte le proprietà configurate, è necessario utilizzare il comando "set" affinché l'applicazione avvenga per tutti gli ID misurazione e/o gli ID proprietà, inclusi quelli implementati tramite i tag del sito collegati.
- Presta particolare attenzione alle funzioni di disattivazione della personalizzazione degli annunci, che in genere vengono implementate con una riga "config".
- Quando si utilizzano i tag del sito collegati: tutte le configurazioni effettuate nel codice gtag.js utilizzando "config" vengono applicate solo alla proprietà associata all'ID misurazione in tale riga di codice e non vengono inviate automaticamente alla proprietà Google Analytics 4 collegata. Se vuoi che la configurazione venga applicata alla proprietà Google Analytics 4 collegata:
- Crea una direttiva "config" distinta e applicala alla proprietà Google Analytics 4 facendo riferimento all'ID misurazione
OPPURE - Configura l'impostazione utilizzando una direttiva "set", nel qual caso la configurazione verrà applicata a tutte le proprietà configurate.
- Crea una direttiva "config" distinta e applicala alla proprietà Google Analytics 4 facendo riferimento all'ID misurazione
Esempi di configurazione
Attivare la raccolta dati di base; configurare l'ID utente
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Configurare le impostazioni dei cookie
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 giorni, in secondi
});
Bloccare un evento page_view
Se non è necessario che un evento page_view venga inviato quando carichi il codice di configurazione (ad esempio in caso di caricamento di un iframe), puoi modificare l'impostazione di configurazione per bloccare l'evento page_view. Considera uno scenario in cui viene inviato un evento page_view, seguito da un accesso al sito effettuato da un utente. Per l'interazione di accesso, utilizzi una direttiva "config" per impostare l'ID utente, ma non vuoi inviare un altro evento page_view. Il codice seguente indica come impedire l'invio dell'evento page_view.
gtag('config', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Eventi
Fai riferimento alla Guida alla migrazione degli eventi.
Dimensioni e metriche personalizzate
Le dimensioni e le metriche personalizzate possono essere utilizzate per estendere le informazioni e importare dati offline, ad esempio da sistemi CRM.
Quando utilizzi il tag Google (gtag.js), le misurazioni delle dimensioni e delle metriche personalizzate vengono trasformate automaticamente in parametri se vengono utilizzati i tag del sito collegati o una proprietà Google Analytics 4 (ad es. "G-XXXXXXXX").
Scopri di più su dimensioni e metriche personalizzate.