Codice di monitoraggio: domini e directory

Questo riferimento descrive i metodi che utilizzi per personalizzare il funzionamento dei report di Google Analytics tra domini, host diversi o sottodirectory di un sito web.

Metodi di dominio/directory GATC

Dettagli metodo

_cookiePathCopy()

_cookiePathCopy(newPath)

Modifica i percorsi di tutti i cookie GATC in base al percorso appena specificato. Utilizza questa funzionalità per monitorare il comportamento degli utenti da una struttura di directory a un'altra nello stesso dominio.

Quando questa funzione viene chiamata, copia immediatamente tutti i cookie nel nuovo percorso dei cookie. Di conseguenza, se il metodo _trackPageview() non è stato chiamato, verranno forniti i valori per i cookie di Analytics esistenti. Per questo motivo, ti consigliamo di chiamare questo metodo dopo _trackPageview() e di altri metodi di configurazione che potrebbero influire sui valori dei cookie o sulla campagna che vuoi trasmettere, ad esempio _setCampaignCookieTimeout() o _setReferrerOverride().

Snippet asincrono (consigliato)
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

Parametri

String   newPath Nuovo percorso in cui archiviare i cookie GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Questo metodo funziona in combinazione con i metodi _setDomainName() e _setAllowLinker() per abilitare il monitoraggio utente tra domini specifico per iframe e link che si aprono in una nuova finestra. Questo metodo restituisce una stringa di tutti i dati relativi ai cookie GATC dal link di avvio aggiungendoli al parametro URL. Successivamente, può essere trasferito a un altro sito o iframe.

Snippet asincrono (consigliato)
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

Parametri

String   targetUrl URL del sito di destinazione a cui inviare i valori dei cookie.

Boolean   useHash Impostato su true per trasferire le variabili del codice di monitoraggio utilizzando il separatore di # tag di ancoraggio al posto di quello predefinito? separatore di stringa di query.

returns

String L'URL del linker.

_link(targetUrl, useHash)

Questo metodo funziona in combinazione con i metodi _setDomainName() e _setAllowLinker() per abilitare il monitoraggio interdominio. Il metodo _link() trasmette i cookie GATC da questo sito a un altro tramite parametri URL (HTTP GET). Inoltre, modifica la posizione document.location e reindirizza l'utente al nuovo URL.

Snippet asincrono (consigliato)
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Parametri

String   targetUrl URL del sito di destinazione a cui inviare i valori dei cookie.

Boolean   useHash Impostato su true per trasferire le variabili del codice di monitoraggio utilizzando il separatore di # tag di ancoraggio al posto di quello predefinito? separatore di stringa di query.


_linkByPost()

_linkByPost(formObject, useHash)

Questo metodo funziona in combinazione con i metodi _setDomainName() e _setAllowLinker() per abilitare il monitoraggio interdominio. Il metodo _linkByPost() trasmette i cookie GATC dal modulo di referral a un altro sito in una stringa aggiunta al valore dell'azione del modulo (HTTP POST). Questo metodo viene in genere utilizzato per monitorare il comportamento degli utenti da un sito a un sito di carrello degli acquisti di terze parti, ma può anche essere utilizzato per inviare dati dei cookie ad altri domini in popup o in iframe.

Snippet asincrono (consigliato)
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Inoltre, il _setAllowLinker() deve essere impostato su true nella pagina web di destinazione per consentire il collegamento.

Parametri

HTMLFormElement   formObject Oggetto modulo che incapsula la richiesta POST.

Boolean   useHash Impostato su true per trasferire le variabili del codice di monitoraggio utilizzando il separatore di # tag di ancoraggio al posto di quello predefinito? separatore di stringa di query.


_setAllowHash()

_setAllowHash(bool)

Imposta il flag hash di dominio. Per impostazione predefinita, questo valore è impostato su true. La funzionalità di hashing del dominio in Google Analytics crea un valore hash dal dominio e utilizza questo numero per verificare l'integrità dei cookie per i visitatori. Se hai più sottodomini, come example1.example.com e example2.example.com, e vuoi monitorare il comportamento degli utenti in entrambi i sottodomini, disattiva l'hashing dei domini in modo che il controllo di integrità dei cookie non rifiuti un cookie utente proveniente da un dominio a un altro. Inoltre, potete disattivare questa funzionalità per ottimizzare le prestazioni nel monitoraggio per pagina.

Parametri

Il valore predefinito di Boolean   true o false è true. Se questo parametro è impostato su true, l'hashing del dominio è attivato. In caso contrario, l'hashing dei domini è disattivato.

_setAllowLinker()

_setAllowLinker(bool)

Imposta il flag della funzionalità Linker come parte dell'abilitazione del monitoraggio degli utenti tra domini. Per impostazione predefinita, questo metodo è impostato su false e il collegamento è disattivato. Consulta anche i metodi _link(), _linkByPost() e _setDomainName() per abilitare il monitoraggio interdominio. Utilizza il metodo _setAllowLinker sul sito di destinazione in modo che il sito di destinazione utilizzi i dati dei cookie nel parametro URL anziché la logica della sessione standard.

Snippet asincrono (consigliato)
_gaq.push(['_setAllowLinker', true]); 

Parametri

Il valore predefinito di Boolean  true o false è false. Se questo parametro è impostato su true, il linker è abilitato. In caso contrario, il collegamento dei domini sarà disattivato.

_setCookiePath()

_setCookiePath(newCookiePath)

Imposta il nuovo percorso del cookie per il tuo sito. Per impostazione predefinita, Google Analytics imposta il percorso del cookie al livello principale (/). Nella maggior parte dei casi, questa è l'opzione appropriata e funziona correttamente con il codice di monitoraggio installato sul tuo sito web, sul tuo blog o nella directory web aziendale. Tuttavia, nei casi in cui l'accesso degli utenti sia limitato solo a una sottodirectory di un dominio, questo metodo può risolvere i problemi di monitoraggio impostando una sottodirectory come percorso predefinito per tutto il monitoraggio.

In genere, devi utilizzare questa opzione se i tuoi dati non vengono monitorati e hai effettuato l'iscrizione a un servizio di blog e hai accesso solo alla tua sottodirectory definita oppure se fai parte di una rete aziendale o universitaria e hai accesso solo alla tua home directory.

Snippet asincrono (consigliato)
_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

Parametri

String   newCookiePath Nuovo percorso del cookie da impostare.

_setDomainName()

_setDomainName(newDomainName)

Imposta il nome di dominio per i cookie GATC. Esistono tre modalità per questo metodo: ("auto" | "none" | [domain]). Per impostazione predefinita, il metodo è impostato su auto, che tenta di risolvere il nome di dominio in base alla proprietà document.domain nel DOM.

Specifica di un dominio

Consulta la Guida al monitoraggio interdominio per un'ampia gamma di esempi che mostrano quando e come specificare un dominio con questo metodo. L'esempio seguente illustra come impostare il nome di dominio su example.com:

Snippet asincrono (consigliato)
_gaq.push(['_setDomainName', 'example.com']); 

Isolamento dei domini di primo livello

Se imposti questo metodo su none, i cookie in un determinato dominio non saranno accessibili da nessun sottodominio.

Snippet asincrono (consigliato)
_gaq.push(['_setDomainName', 'none']); 

Parametri

String   newDomainName Nuovo nome di dominio predefinito da impostare.

_storeGac(Bollino)

Determina se il cookie GAC deve essere creato o meno. Per impostazione predefinita, il cookie GAC viene scritto dallo script e non devi fare nulla per scriverlo. Puoi disattivare l'impostazione di questo cookie con il comando riportato di seguito.

Snippet asincrono (consigliato)
_gaq.push(['_storeGac', false]);