Codice di monitoraggio: oggetto globale _gat

ga.js è una libreria precedente. Se stai iniziando una nuova implementazione, ti consigliamo di utilizzare l'ultima versione di questa libreria, analytics.js. Per le implementazioni esistenti, scopri come eseguire la migrazione da ga.js ad analytics.js.

L'oggetto globale _gat viene utilizzato per creare e recuperare oggetti tracker, da cui vengono richiamati tutti gli altri metodi. Pertanto, i metodi in questo elenco devono essere eseguiti solo da un oggetto tracker creato utilizzando la variabile globale _gat. Tutti gli altri metodi devono essere chiamati utilizzando l'oggetto globale _gaq per il monitoraggio asincrono.

Metodi oggetto _gat

• _getTracker(account) ritirato
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

Dettagli del metodo

_getTracker()

_getTracker(account)

Questo metodo è stato ritirato. Usa invece il criterio _gat._createTracker(opt_account, opt_name).

Crea un oggetto tracker per lo specifico ID proprietà web. Se questo metodo viene chiamato più di una volta per lo stesso ID account Analytics, viene creato un nuovo oggetto per ogni chiamata.

_gat._getTracker('UA-65432-1');

Parametri

String account L'ID proprietà web completo (ad es. UA-65432-1) per l'oggetto tracker.

returns

Tracker L'oggetto di monitoraggio creato.

---

_createTracker()

_createTracker(opt_account, opt_name)

Crea un nuovo oggetto tracker e gli assegna il nome specificato. Se non viene indicato alcun nome, ne verrà generato uno. Gli oggetti tracker vengono archiviati con i loro nomi, in modo che possano essere recuperati tramite _getTrackerByName. Se vengono creati due tracker con lo stesso nome, il secondo sovrascriverà il primo e il primo non sarà più recuperabile tramite _getTrackerByName.

_gat._createTracker('UA-65432-1');

_gat._createTracker('UA-65432-2', 't2');

Parametri

String opt_account L'ID proprietà web completo (ad es. UA-XXXXX-X) per l'oggetto tracker.
String opt_name Nome facoltativo in cui riporre il tracker. Usa questo nome per recuperare il tracker tramite _getTrackerByName

returns

Tracker L'oggetto di monitoraggio creato.

---

_getTrackerByName()

_getTrackerByName(opt_name)

Recupera l'oggetto tracker con il nome specificato. Se non viene specificato alcun nome, viene utilizzato il valore predefinito, ovvero la stringa vuota ("'"). Se non esiste un tracker con il nome specificato, viene creato un nuovo tracker, assegnato a quel nome e restituito.

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

Parametri

String opt_name Nome facoltativo del tracker da recuperare. Il valore predefinito è la stringa vuota ("'").

returns

Tracker L'oggetto di monitoraggio recuperato o creato.

---

_anonymizeIp()

_anonymizeIp()

Indica a Google Analytics di mascherare le informazioni inviate dagli oggetti tracker rimuovendo l'ultimo ottetto dell'indirizzo IP prima della memorizzazione. Tieni presente che ciò ridurrà leggermente la precisione dei rapporti geografici.

Se utilizzi questa funzione per mascherare il monitoraggio, devi utilizzare la funzione push e associare correttamente la funzione all'oggetto tracker, come illustrato di seguito.

Snippet asincrono (consigliato)

var _gaq = _gaq || [];
_gaq.push (['_setAccount', 'UA-XXXXXXX-YY']);
_gaq.push (['_gat._anonymizeIp']);
_gaq.push (['_trackPageview']);

Snippet tradizionale (ga.js)

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_forceSSL()

_forceSSL(bool)

Configura Google Analytics in modo che invii tutti gli hit utilizzando SSL, anche dalle pagine non sicure (HTTP).

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_gat._forceSSL']);       // Send all hits using SSL, even from insecure (HTTP) pages.
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();