Gli oggetti tracker (noti anche come "tracker") sono oggetti che possono raccogliere e archiviare i dati e inviarli a Google Analytics.
Quando crei un nuovo tracker, devi specificare un ID monitoraggio (che corrisponde all'ID proprietà corrispondente a una delle proprietà Google Analytics) e un dominio dei cookie, che specifica la modalità di archiviazione dei cookie. Il valore consigliato 'auto' specifica la configurazione automatica del dominio dei cookie.
Se non esiste un cookie per il dominio specificato, viene generato e memorizzato nel cookie un ID client e l'utente viene identificato come nuovo. Se esiste un cookie contenente un valore ID cliente, tale ID cliente viene impostato sul tracker e l'utente viene identificato come di ritorno.
Al momento della creazione, gli oggetti del tracker raccolgono anche informazioni sul contesto di navigazione corrente, come il titolo e l'URL della pagina e sul dispositivo, ad esempio la risoluzione dello schermo, le dimensioni dell'area visibile e la codifica dei documenti. Quando è il momento di inviare i dati a Google Analytics, vengono inviate tutte le informazioni attualmente memorizzate sul tracker.
Il metodo di creazione
La libreria analytics.js offre diversi modi per creare i tracker, ma il modo più comune è utilizzare il comando create e passare i campi tracking ID e cookie domain come secondo e terzo parametro:
ga('create', 'UA-XXXXX-Y', 'auto');
Tracker nomi
Se vuoi, puoi anche assegnare un nome al tracker passando il campo name come quarto argomento nel comando create. È necessario assegnare un nome a un tracker nei casi in cui sia necessario creare più tracker per la stessa pagina. Per ulteriori dettagli sui motivi per cui è necessario eseguire questa operazione, consulta la sezione seguente, Utilizzo di più tracker.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');
La creazione di un tracker senza impostare il campo name è nota come creazione di un tracker "default". A un tracker predefinito viene assegnato internamente il nome "t0".
Specificare i campi al momento della creazione
Può essere trasmesso anche un oggetto campi facoltativo che consente di impostare qualsiasi campo analytics.js al momento della creazione, in modo che venga memorizzato nel tracker e applicato a tutti gli hit inviati.
ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
userId: '12345'
});
Come per tutte le chiamate alla funzione ga(), puoi utilizzare l'oggetto campi anche per specificare tutti i campi insieme:
ga('create', {
trackingId: 'UA-XXXXX-Y',
cookieDomain: 'auto',
name: 'myTracker',
userId: '12345'
});
Per informazioni più complete, consulta il riferimento del metodo create.
Uso di più tracker
In alcuni casi potresti voler inviare i dati a più proprietà da una singola pagina. Questa operazione è utile per i siti con più proprietari che supervisionano sezioni di un sito e che ogni proprietario può visualizzare la propria proprietà.
Per monitorare i dati di due proprietà distinte, devi creare due tracker separati, di cui almeno uno deve essere un tracker denominato. I due comandi seguenti creano un tracker predefinito e un tracker denominato "clientTracker":
ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');
Esecuzione di comandi per un tracker specifico
Per eseguire i comandi analytics.js per un tracker specifico, fai precedere il nome del comando dal nome del tracker, seguito da un punto. Quando non specifichi un nome tracker, il comando viene eseguito sul tracker predefinito.
Per inviare le visualizzazioni di pagina per i due tracker sopra indicati, devi eseguire i due comandi seguenti:
ga('send', 'pageview');
ga('clientTracker.send', 'pageview');
Le guide future approfondiranno la sintassi per l'esecuzione di comandi specifici. Puoi anche fare riferimento al riferimento della coda di comando per visualizzare la sintassi completa dei comandi per tutti i comandi analytics.js.
Passaggi successivi
Una volta creato un tracker, potresti dover accedere ai dati memorizzati su tale oggetto tracker. La guida successiva spiega come ottenere e impostare i dati del tracker.