Codice di monitoraggio: oggetto globale _gaq

L'oggetto globale _gaq può essere utilizzato direttamente per il monitoraggio asincrono delle pagine tramite il metodo push(...). Offre anche metodi per creare oggetti tracker, che devono essere utilizzati solo in rari casi.

Per il monitoraggio tradizionale delle pagine, utilizza invece l'oggetto globale _gat.

Metodi oggetto _gaq

Dettagli del metodo

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    Crea un oggetto tracker a cui è possibile fare riferimento per nome quando si effettuano chiamate di monitoraggio asincrono. Se non viene fornito alcun nome, sarà la stringa vuota '', che rappresenta il tracker predefinito nella sintassi asincrona. Se esiste già un tracker asincrono per il nome specificato, verrà sovrascritto con il nuovo tracker.

    Nota: in genere questo metodo è sicuro solo all'interno di una funzione che è stata inviata a _gaq. Deve essere utilizzata solo in rari casi. 
    _gaq._createAsyncTracker('UA-65432-1');

    Parametri

      String accountId L'ID proprietà web completo (ad es. UA-65432-1) per l'oggetto tracker.
      String opt_name Il nome in cui archiviare l'oggetto tracker. Utilizza questo nome per fare riferimento all'oggetto tracker nelle chiamate del monitoraggio asincrono in un secondo momento.

    returns

      Tracker L'oggetto di monitoraggio creato.

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    Restituisce l'oggetto tracker creato in precedenza con il nome specificato. Se non viene fornito alcun nome, verrà utilizzato il nome del tracker predefinito (la stringa vuota ''). Se non esiste alcun oggetto tracker con il nome specificato, viene creato un nuovo tracker, assegnato a quel nome e restituito.

    Nota: in genere questo metodo è sicuro solo all'interno di una funzione che è stata inviata a _gaq. Deve essere utilizzata solo in rari casi. 
    _gaq._getAsyncTracker();

    Parametri

      String opt_name Il nome dell'oggetto tracker da recuperare.

    returns

      Tracker L'oggetto di monitoraggio recuperato o creato.

push

    push(commandArray)
    Esegue il valore command array specificato, che non è altro che un array JavaScript conforme al formato seguente. Il primo elemento dell'array deve essere il nome di un metodo dell'oggetto tracker passato come stringa. Gli altri elementi dell'array sono i valori da passare come argomenti alla funzione.

    Il seguente utilizzo è tipico:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    Questa funzione è denominata push per poter utilizzare un array al posto di _gaq prima che Analytics sia completamente caricato. Durante il caricamento di Analytics, i comandi verranno inviati in coda o push nell'array. Al termine del caricamento, Analytics sostituisce l'array con l'oggetto _gaq ed esegue tutti i comandi in coda. Le chiamate successive a _gaq.push si risolvono in questa funzione, che esegue i comandi man mano che vengono inviati.

    È possibile assegnare un nome ai tracker facendo precedere il nome del tracker (insieme a un punto) al nome del metodo. Se il nome di una funzione è qualificato con il nome di un tracker, viene eseguito su quel tracker.

    L'esempio seguente crea e utilizza un tracker chiamato arbitrariamente myTracker.
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    Nota: i tracker vengono creati la prima volta che un comando li fa riferimento. Il tracker predefinito viene creato tramite il primo comando che non assegna un nome esplicito al tracker. Il nome predefinito del tracker è la stringa vuota ''.

    Oltre a eseguire il push degli array di comandi, puoi anche eseguire il push degli oggetti delle funzioni. Questo può essere particolarmente utile per i metodi di monitoraggio che restituiscono valori. Queste funzioni possono fare riferimento sia a _gat che a _gaq.
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    Puoi anche utilizzare la sintassi push direttamente nel codice HTML della pagina.
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    Finché lo snippet asincrono di Analytics è presente sopra il link, i clic verranno acquisiti senza errori; anche se Analytics non è stato completamente caricato al momento del clic. Questo è uno dei numerosi vantaggi del monitoraggio asincrono.

    Infine, invece di digitare _gaq.push(...) per ogni array di comandi, puoi eseguire il push di tutti i comandi contemporaneamente. Il seguente codice dimostra questa tecnica. Per ulteriori dettagli, consulta la guida all'utilizzo dello snippet asincrono. 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      Parametri

        Array commandArray Il comando da eseguire. È possibile eseguire il push di uno o più di questi elementi nella stessa chiamata.

      returns

        Number Il numero di comandi che non è stato possibile eseguire.