Codice di monitoraggio: domini e directory

Questo riferimento descrive i metodi utilizzati per personalizzare il funzionamento dei report di Google Analytics su più domini, su host diversi o all'interno di sottodirectory di un sito web.

Metodi GATC per dominio/directory

Dettagli del metodo

_cookiePathCopy()

_cookiePathCopy(newPath)

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

Quando questa funzione viene richiamata, tutti i cookie vengono copiati immediatamente nel nuovo percorso dei cookie. Di conseguenza, se il metodo _trackPageview() non è stato richiamato, verranno forniti i valori degli eventuali cookie di Analytics esistenti. Per questo motivo, ti consigliamo di richiamare questo metodo dopo il giorno _trackPageview() e altri metodi di configurazione che potrebbero influire sui valori dei cookie o delle campagne 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 degli utenti interdominio in particolare per gli iframe e i link che si aprono in una nuova finestra. Questo metodo restituisce una stringa di tutti i dati del cookie GATC dal link iniziale aggiungendola al parametro URL. Questo può essere quindi trasmesso 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 target a cui inviare i valori dei cookie.

Boolean   useHash Imposta il valore su true per trasmettere le variabili del codice di monitoraggio utilizzando il separatore di tag anchor # anziché il valore 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 degli utenti 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 target a cui inviare i valori dei cookie.

Boolean   useHash Imposta il valore su true per trasmettere le variabili del codice di monitoraggio utilizzando il separatore di tag anchor # anziché il valore 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 degli utenti interdominio. Il metodo _linkByPost() trasmette i cookie GATC dal modulo di riferimento a un altro sito in una stringa aggiunta al valore dell'azione del modulo (HTTP POST). Questo metodo viene generalmente utilizzato per monitorare il comportamento degli utenti da un sito a quello di un carrello degli acquisti di terze parti, ma può essere utilizzato anche per inviare i dati dei cookie ad altri domini all'interno di 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, _setAllowLinker() deve essere impostato su true nella pagina web di destinazione affinché il collegamento funzioni.

Parametri

HTMLFormElement   formObject Oggetto modulo che incapsula la richiesta POST.

Boolean   useHash Imposta il valore su true per trasmettere le variabili del codice di monitoraggio utilizzando il separatore di tag anchor # anziché il valore predefinito ? separatore di stringa di query.


_setAllowHash()

_setAllowHash(bool)

Imposta il flag Consenti hash del dominio. Per impostazione predefinita, questo valore è impostato su true. La funzionalità di hashing del dominio in Google Analytics crea un valore hash dal tuo 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, devi disattivare l'hashing dei domini in modo che il controllo dell'integrità dei cookie non rifiuti un cookie dell'utente proveniente da un dominio all'altro. Inoltre, puoi disattivare questa funzionalità per ottimizzare il rendimento del monitoraggio per pagina.

Parametri

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

_setAllowLinker()

_setAllowLinker(bool)

Imposta il flag della funzionalità Linker come parte dell'abilitazione del monitoraggio degli utenti interdominio. Per impostazione predefinita, questo metodo è impostato su false e il collegamento è disattivato. Vedi anche i metodi _link(), _linkByPost() e _setDomainName() per abilitare il monitoraggio interdominio. Utilizza il metodo _setAllowLinker sul sito di destinazione, in modo che quest'ultimo utilizzi i dati dei cookie nel parametro URL anziché la logica di 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 viene abilitato. In caso contrario, il collegamento al dominio viene disattivato.

_setCookiePath()

_setCookiePath(newCookiePath)

Imposta il nuovo percorso dei cookie per il tuo sito. Per impostazione predefinita, Google Analytics imposta il percorso dei cookie al livello principale (/). Nella maggior parte dei casi, questa è l'opzione appropriata e funziona correttamente con il codice di monitoraggio che installi nella directory web del tuo sito web, del tuo blog o della tua azienda. Tuttavia, nei casi in cui l'accesso utente 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, è utile se i tuoi dati non vengono monitorati e hai effettuato l'iscrizione a un servizio di blog e hai accesso solo alla sottodirectory definita oppure se ti trovi su 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 dei cookie da impostare.

_setDomainName()

_setDomainName(newDomainName)

Imposta il nome di dominio per i cookie GATC. Questo metodo prevede tre modalità: ("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 una serie di esempi che illustrano 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

L'impostazione di questo metodo su none garantisce che i cookie in un determinato dominio non siano accessibili da alcun sottodominio.

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

Parametri

String   newDomainName Nuovo nome di dominio predefinito da impostare.

_storeGac(bool)

Determina se il cookie GAC deve essere creato o meno. Per impostazione predefinita, il cookie GAC viene scritto dallo script e non è richiesta alcuna azione da parte tua per scriverlo. Puoi disabilitare l'impostazione di questo cookie utilizzando il comando seguente.

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