Código de seguimiento: dominios y directorios

En esta referencia, se describen los métodos que utilizas para personalizar el funcionamiento de los informes de Google Analytics en los distintos dominios, en diferentes hosts o dentro de los subdirectorios de un sitio web.

Métodos de directorio o dominio de GATC

Detalles del método

_cookiePathCopy()

_cookiePathCopy(newPath)

Cambia las rutas de todas las cookies de GATC a la ruta recién especificada. Usa esta función para realizar un seguimiento del comportamiento de los usuarios de una estructura de directorio a otra en el mismo dominio.

Cuando se llama a esta función, copia inmediatamente cualquier cookie en la ruta de acceso nueva. Por lo tanto, si no se llamó al método _trackPageview(), se proporcionarán los valores para las cookies de Analytics existentes. Por ese motivo, te recomendamos que llames a este método después de _trackPageview(), así como a otros métodos de configuración que puedan afectar los valores de las cookies o los valores de la campaña que quieras transmitir, como _setCampaignCookieTimeout() o _setReferrerOverride().

Fragmento asíncrono (recomendado)
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

Parámetros

String   newPath Nueva ruta de acceso para almacenar las cookies de GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Este método funciona junto con los métodos _setDomainName() y _setAllowLinker() a fin de habilitar el seguimiento de usuarios multidominio específicamente para iFrames y vínculos que se abren en una ventana nueva. Este método muestra una string de todos los datos de cookies de GATC del vínculo de inicio agregándolos al parámetro de URL. Luego, se puede pasar a otro sitio o a iFrame.

Fragmento asíncrono (recomendado)
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

Parámetros

String   targetUrl Es la URL del sitio de destino al que se enviarán los valores de las cookies.

Boolean   useHash ¿Se configura como verdadero para pasar variables de código de seguimiento mediante el separador de etiqueta de anclaje # en lugar del valor predeterminado? separador de cadena de consulta.

resultados

String La URL del vinculador.

_link(targetUrl, useHash)

Este método funciona en conjunto con los métodos _setDomainName() y _setAllowLinker() para habilitar el seguimiento de usuarios multidominio. El método _link() pasa las cookies de GATC de este sitio a otro a través de parámetros de URL (HTTP GET). También cambia document.location y redirecciona al usuario a la URL nueva.

Fragmento asíncrono (recomendado)
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Parámetros

String   targetUrl Es la URL del sitio de destino al que se enviarán los valores de las cookies.

Boolean   useHash ¿Se configura como verdadero para pasar variables de código de seguimiento mediante el separador de etiqueta de anclaje # en lugar del valor predeterminado? separador de cadena de consulta.


Vínculo de publicación

_linkByPost(formObject, useHash)

Este método funciona en conjunto con los métodos _setDomainName() y _setAllowLinker() para habilitar el seguimiento de usuarios multidominio. El método _linkByPost() pasa las cookies de GATC del formulario de referencia a otro sitio en una string anexada al valor de acción del formulario (HTTP POST). Por lo general, este método se usa cuando se realiza un seguimiento del comportamiento de los usuarios de un sitio a un sitio de carrito de compras de terceros, pero también se puede usar para enviar datos de cookies a otros dominios en ventanas emergentes o en iframes.

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

Además, _setAllowLinker() debe configurarse como true en la página web de destino para que funcione la vinculación.

Parámetros

HTMLFormElement   formObject Objeto del formulario que encapsula la solicitud POST.

Boolean   useHash ¿Se configura como verdadero para pasar variables de código de seguimiento mediante el separador de etiqueta de anclaje # en lugar del valor predeterminado? separador de cadena de consulta.


_setAllowHash()

_setAllowHash(bool)

Establece la marca de hash del dominio permitido. De forma predeterminada, este valor se establece en true. La funcionalidad de hash de dominio de Google Analytics crea un valor de hash de tu dominio y usa este número para verificar la integridad de las cookies de los visitantes. Si tienes varios subdominios, como example1.example.com y example2.example.com, y quieres hacer un seguimiento del comportamiento de los usuarios en ambos subdominios, desactiva el hash de dominio para que la verificación de integridad de las cookies no rechace las cookies de usuarios que provengan de un dominio a otro. Además, puedes desactivar esta función para optimizar el rendimiento del seguimiento por página.

Parámetros

Boolean   true o false El valor predeterminado es true. Si este parámetro se establece en true, se habilita el hash de dominio. De lo contrario, la codificación hash de dominio está inhabilitada.

_setAllowLinker()

_setAllowLinker(bool)

Establece la marca de funcionalidad del vinculador como parte de la habilitación del seguimiento de usuarios multidominio. De forma predeterminada, este método se establece en false y la vinculación está inhabilitada. Consulta también los métodos _link(), _linkByPost() y _setDomainName() para habilitar el seguimiento multidominio. Usa el método _setAllowLinker en el sitio de destino para que este use los datos de cookies en el parámetro de URL, en lugar de la lógica de la sesión estándar.

Fragmento asíncrono (recomendado)
_gaq.push(['_setAllowLinker', true]); 

Parámetros

Boolean  true o false El valor predeterminado es false. Si este parámetro se establece en true, se habilita el vinculador. De lo contrario, se inhabilitará la vinculación del dominio.

_setCookiePath()

_setCookiePath(newCookiePath)

Establece la nueva ruta de acceso de cookies para tu sitio. De forma predeterminada, Google Analytics establece la ruta de acceso de la cookie en el nivel de raíz (/). En la mayoría de los casos, esta es la opción adecuada y funciona correctamente con el código de seguimiento que instalas en tu sitio web, blog o directorio web corporativo. Sin embargo, en algunos casos en los que el acceso del usuario está restringido solo a un subdirectorio de un dominio, este método puede resolver los problemas de seguimiento mediante la configuración de un subdirectorio como la ruta predeterminada para todo el seguimiento.

Por lo general, la usarás si no se realiza un seguimiento de tus datos, te suscribiste a un servicio de blog y solo tienes acceso a tu subdirectorio definido, o si estás en una red corporativa o universitaria y solo tienes acceso a tu directorio principal.

Fragmento asíncrono (recomendado)
_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

Parámetros

String   newCookiePath Se agregó una nueva ruta de acceso de cookies.

Nombre_del_dominio()

_setDomainName(newDomainName)

Establece el nombre de dominio para las cookies de GATC. Este método tiene tres modos: ("auto" | "none" | [domain]). De forma predeterminada, el método se establece en auto, que intenta resolver el nombre de dominio en función de la propiedad document.domain en el DOM.

Especifica un dominio

Consulta la Guía de seguimiento de dominio cruzado para ver varios ejemplos que ilustran cuándo y cómo especificar un dominio con este método. En el siguiente ejemplo, se muestra cómo establecer el nombre de dominio en example.com:

Fragmento asíncrono (recomendado)
_gaq.push(['_setDomainName', 'example.com']); 

Aislar dominios de nivel superior

Establecer este método en none garantiza que ningún subdominio pueda acceder a las cookies en un dominio determinado.

Fragmento asíncrono (recomendado)
_gaq.push(['_setDomainName', 'none']); 

Parámetros

String   newDomainName Nombre de dominio predeterminado nuevo que se debe configurar.

_tiendaGac(bool)

Determina si se debe crear la cookie de GAC o no. De forma predeterminada, la cookie se escribe con la secuencia de comandos, y no es necesario que hagas nada para escribirla. Puedes inhabilitar la configuración de esta cookie con el siguiente comando.

Fragmento asíncrono (recomendado)
_gaq.push(['_storeGac', false]);