Codice di monitoraggio: configurazione di base

Questo riferimento descrive i metodi da utilizzare per personalizzare tutti gli aspetti dei report di Google Analytics.

Metodi di base ga.js

Dettagli del metodo

_deleteCustomVar()

_deleteCustomVar(index)

Questo metodo elimina la variabile assegnata all'indice fornito, se esistente. Ad esempio, puoi impostare una variabile personalizzata a livello di visitatore per poi decidere in un secondo momento di non utilizzarla più.

Snippet asinc (consigliato)

_gaq.push(['_deleteCustomVar', 1]);

Parametri

Int   index L'indice della variabile personalizzata da eliminare.

_getName()

_getName()

Restituisce il nome assegnato al tracker al momento della creazione.

Snippet asinc (consigliato)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

returns

String Il nome del tracker.

_getAccount()

_getAccount()

Restituisce l'ID Google Analytics per questo oggetto tracker. Se stai monitorando le pagine del tuo sito web in più account, puoi utilizzare questo metodo per determinare l'account associato a un determinato oggetto tracker.

Snippet asinc (consigliato) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

returns

String ID account con cui viene creata l'istanza di questo oggetto tracker.

_getVersion()

_getVersion()

Restituisce il numero di versione GATC.

Snippet asinc (consigliato) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

returns

Numero di versione GATC String.

_getVisiteorCustomVar()

_getVisitorCustomVar(index)

Restituisce il valore della variabile personalizzata a livello di visitatore assegnato per l'indice specificato.

Snippet asinc (consigliato) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

Parametri

Int   index L'indice della variabile personalizzata a livello di visitatore.

returns

String Il valore della variabile personalizzata a livello di visitatore. Restituisce undefined se non è possibile recuperare la variabile per l'indice specificato.

_initData()

_initData()Deprecato. initData() ora viene eseguito automaticamente nel codice di monitoraggio ga.js.

Inizializza o reinizializza l'oggetto GATC (Google Analytics Tracker Code).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Utilizzato esclusivamente per il monitoraggio asincrono. Imposta l'ID proprietà web per l'oggetto di monitoraggio.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

Parametri

String accountID L'ID proprietà web completo (ad es. UA-65432-1) dell'oggetto tracker.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Questo metodo è obsoleto. Usa invece _setVisitorCookieTimeout(cookieTimeoutMillis).

Imposta la scadenza del cookie visitatore di Google Analytics in millisecondi. Per impostazione predefinita, il cookie del visitatore è impostato per scadere tra 2 anni. Se preferisci, puoi modificare la data di scadenza del cookie del visitatore utilizzando questo metodo. Ad esempio, per impostare la scadenza del cookie del visitatore su 7 giorni, devi utilizzare il seguente codice:

pageTracker._setCookiePersistence(604800000);

parametri

Number   milliseconds Scadenza dei nuovi cookie dei visitatori.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Imposta una variabile personalizzata con il nome, il valore e l'ambito specificati per la variabile. Esiste un limite di 128 byte per i name e value combinati.

Snippet asinc (consigliato) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

returns

Boolean Questo metodo restituisce true se la variabile personalizzata è stata impostata correttamente e false in caso contrario (ad es. se la lunghezza della stringa nome/valore supera 128 byte o se utilizzi uno slot errato).

Parametri

Int      index       Obbligatorio. L'area utilizzata per la variabile personalizzata. I valori possibili sono 1-5, inclusi.

String   name        Obbligatorio. Il nome della variabile personalizzata.

String   value       Obbligatorio. Il valore della variabile personalizzata.

Int      opt_scope   Facoltativo. L'ambito utilizzato per la variabile personalizzata. I valori possibili sono 1 per il livello di visitatore, 2 per il livello di sessione e 3 per il livello di pagina.

_setSampleRate()

_setSampleRate(newRate)

Imposta la nuova frequenza di campionamento. Se il tuo sito web è particolarmente grande e soggetto a forti picchi di traffico, l'impostazione della frequenza di campionamento garantisce un monitoraggio dei report senza interruzioni. Il campionamento in Google Analytics viene eseguito in modo coerente per i visitatori unici, il che garantisce l'integrità delle tendenze e dei report anche quando il campionamento è attivato, in quanto i visitatori unici rimangono inclusi o esclusi dal campione, come stabilito all'avvio del campionamento.

Questo metodo deve essere specificato solo nello stesso momento in cui viene chiamato _setAccount(), di solito una volta per pagina o applicazione (ogni volta che inizializza il codice di monitoraggio stesso). Tieni presente che il valore della frequenza di campionamento specificato rimane attivo finché l'oggetto di monitoraggio persiste.

Snippet asinc (consigliato) 

_gaq.push(['_setSampleRate', '2.5']);

Parametri

String newRate Nuova frequenza di campionamento da impostare. Specifica una stringa numerica compresa tra 0 e 100 (con precisione con due cifre decimali).

_setSessionTimeout()

_setSessionTimeout(newTimeout)

Questo metodo è obsoleto. Usa invece _setSessionCookieTimeout(cookieTimeoutMillis).

Imposta il nuovo timeout della sessione in secondi. Per impostazione predefinita, il timeout della sessione è impostato su 30 minuti (1800 secondi). Il timeout sessione è utilizzato per calcolare le visite (consulta Come viene definita una sessione in Analytics). Se vuoi modificare la definizione di "sessione" per le tue esigenze specifiche, puoi passare il numero di secondi per definire un nuovo valore. Questo influirà sui report sulle visite in ogni sezione in cui viene calcolato il numero di visite e dove le visite vengono utilizzate per calcolare altri valori. Ad esempio, il numero di visite in genere aumenta se riduci il timeout della sessione e in genere diminuisce se lo aumenti.

parametri

String newTimeout Nuovo timeout di sessione da impostare in secondi.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Imposta il nuovo timeout del cookie di sessione in millisecondi. Per impostazione predefinita, il timeout della sessione è impostato su 30 minuti. Il timeout della sessione viene utilizzato per calcolare le visite, poiché una visita termina dopo 30 minuti di inattività del browser o all'uscita dal browser. Se desideri modificare la definizione di "sessione" per le tue esigenze specifiche, puoi passare il numero di millisecondi per definire un nuovo valore. Questo influirà sui report sulle visite in ogni sezione in cui viene calcolato il numero di visite e dove le visite vengono utilizzate per calcolare altri valori. Ad esempio, il numero di visite aumenterà se riduci il timeout della sessione e diminuirà se lo aumenti. Puoi modificare il timeout della scadenza impostandolo su 0 per indicare che il cookie deve essere eliminato alla chiusura del browser.

Snippet asinc (consigliato) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


Parametri

Number cookieTimeoutMillis Nuovo timeout di sessione in millisecondi o 0 per eliminare il cookie alla chiusura del browser.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Definisce una nuova dimensione del set di esempio per la raccolta dei dati Velocità sito. Per impostazione predefinita, un campione fisso dell'1% dei visitatori del tuo sito compone il pool di dati da cui sono derivate le metriche di Velocità del sito. Se il tuo sito ha un numero relativamente ridotto di visitatori giornalieri, ad esempio 100.000 o meno, ti consigliamo di modificare il campionamento impostando una frequenza maggiore. Ciò fornirà una maggiore granularità per quanto riguarda il tempo di caricamento delle pagine e altre metriche relative alla velocità del sito. Per informazioni dettagliate sui report Velocità del sito, consulta Velocità sito nel Centro assistenza.

Il metodo _setSiteSpeedSampleRate() deve essere chiamato prima del giorno _trackPageview() per essere efficace.

Analytics limita gli hit della raccolta Velocità del sito per una singola proprietà a una percentuale maggiore dell'1% degli utenti o a 10.000 hit al giorno per garantire una distribuzione equa delle risorse di sistema per questa funzionalità.

Nota: consigliamo vivamente ai siti con più di 1 milione di hit al giorno di mantenere la selezione del campione impostata sulla tariffa predefinita dell'1%. L'impostazione di un numero maggiore per la dimensione del campione non aumenterà la dimensione del campione.

Snippet asinc (consigliato) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

Parametri

Number sampleRate Valore compreso tra 0 e 100 per definire la percentuale di visitatori del tuo sito che verrà misurata ai fini della velocità del sito. Ad esempio, un valore di 5 imposta l'esempio di raccolta Velocità sito al 5%.

_setVisiteorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Imposta la scadenza del cookie visitatore di Google Analytics in millisecondi. Per impostazione predefinita, il cookie dei visitatori scade dopo 2 anni. Se preferisci, puoi modificare la data di scadenza del cookie del visitatore utilizzando questo metodo. Puoi modificare il timeout della scadenza impostandolo su 0 per indicare che il cookie deve essere eliminato alla chiusura del browser.

Snippet asinc (consigliato) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

Parametri

Number cookieTimeoutMillis Nuovo tempo di scadenza dei cookie dei visitatori in millisecondi o 0 per eliminare il cookie alla chiusura del browser.

_setVar()

_setVar(newVal)

Questo metodo è obsoleto. Utilizza _setCustomVar().

Imposta o definisce un segmento visitatori personalizzato con la stringa fornita. Puoi utilizzare questo valore per fornire una segmentazione aggiuntiva degli utenti al tuo sito web. Ad esempio, potresti avere una pagina di accesso o un modulo che attiva un valore in base all'input di un visitatore, come una preferenza scelta dal visitatore o un'opzione relativa alla privacy. Questa variabile viene quindi aggiornata nel cookie per quel visitatore. Una volta implementato sul tuo sito e i dati vengono raccolti con questo metodo, il segmento appena definito compare nei report Definiti dall'utente nella sezione Visitatori dei report di Analytics. Inoltre, puoi accedere al segmento Valore definito dall'utente nel report Dettagli contenuto per conoscere la percentuale di visitatori di una pagina che appartengono a un determinato segmento da te definito.

parametri

String newVal Nuovo valore definito dall'utente da impostare.

_trackPageLoadTime()

_trackPageLoadTime()

Questo metodo è deprecato perché i report Velocità del sito vengono attivati automaticamente per tutti gli utenti. Utilizza _setSiteSpeedSampleRate() per regolare la frequenza di campionamento per i report Velocità del sito.

Attiva i report Velocità del sito per questa pagina. Inserisci questo metodo per ogni pagina del tuo sito per cui vuoi generare i report Velocità del sito. Per maggiori informazioni sui report Velocità del sito in Analytics, consulta l'articolo Velocità del sito nel nostro Centro assistenza.

Verifica delle modifiche

Se visualizzi dati nei report, significa che l'impostazione è corretta. Se dopo 24 ore non visualizzi alcun dato, controlla la personalizzazione per assicurarti di non aver commesso errori. Consulta la sezione Risoluzione dei problemi relativi al codice di monitoraggio per un elenco degli errori più comuni relativi al codice di monitoraggio. Questa guida alla risoluzione dei problemi contiene anche i passaggi di base per il debug e ulteriori informazioni sul debug.

Tieni presente che l'attivazione del monitoraggio Velocità sito per il tuo sito comporta una richiesta supplementare ai server di Google Analytics, distinta dalla richiesta di monitoraggio GIF per le visualizzazioni di pagina. Per ridurre al minimo l'impatto sulla latenza complessiva del sito, questa richiesta viene inviata solo su un campione di visualizzazioni di pagina del tuo sito. Per questo motivo, non sempre potresti vedere la richiesta GIF per la velocità del sito quando stai effettuando il debug di questa funzione in Firebug o in altri strumenti. Ciò è normale e previsto.

Snippet asinc (consigliato) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Logica principale per GATC (Google Analytics Tracker Code). Se le funzionalità di collegamento sono abilitate, tenta di estrarre i valori dei cookie dall'URL. In caso contrario, prova a estrarre i valori dei cookie da document.cookie. Inoltre, aggiorna o crea cookie in base alle esigenze e poi li scrive di nuovo nell'oggetto del documento. Raccoglie tutte le metriche appropriate da inviare a UCFE (Urchin Collector Front-end).

Snippet asinc (consigliato) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

Parametri

String opt_pagePath Parametro facoltativo per indicare il percorso della pagina in cui monitorare le metriche. Quando utilizzi questa opzione, inserisci una barra iniziale (/) per indicare il percorso della pagina.