Código de seguimiento: dominios y directorios

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

Métodos de dominio/directorio de GATC

Detalles del método

_cookiePathCopy()

_cookiePathCopy(newPath)

Cambia las rutas de todas las cookies de GATC a la ruta que se especificó recientemente. Usa esta función para realizar un seguimiento del comportamiento del usuario de una estructura de directorio a otra en el mismo dominio.

Cuando se llama a esta función, copia inmediatamente las cookies en la ruta de acceso de cookies nueva. Por lo tanto, si no se llamó al método _trackPageview(), se proporcionarán los valores de 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 desees pasar, como _setCampaignCookieTimeout() o _setReferrerOverride().

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

Parámetros

String   newPath Nueva ruta para almacenar las cookies de GATC

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Este método funciona en conjunto con los métodos _setDomainName() y _setAllowLinker() para 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 cadena de todos los datos de la cookie de GATC del vínculo iniciador que se agrega al parámetro de URL. Luego, se puede pasar a otro sitio o 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 URL del sitio de destino al que se envían los valores de las cookies.

Boolean   useHash Se establece como verdadero para pasar las variables de código de seguimiento mediante el separador # de etiquetas de anclaje en lugar del valor predeterminado? separador de cadenas de consulta.

resultados

String La URL del vinculador.

_vínculo()

_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 (GET de HTTP). También cambia document.location y redirecciona al usuario a la nueva URL.

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 URL del sitio de destino al que se envían los valores de las cookies.

Boolean   useHash Se establece como verdadero para pasar las variables de código de seguimiento mediante el separador # de etiquetas de anclaje en lugar del valor predeterminado? separador de cadenas de consulta.

_linkByPost()

_linkByPost(formObject, useHash)

Este método funciona junto 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 cadena adjunta al valor de acción del formulario (HTTP POST). Por lo general, este método se usa al realizar un seguimiento del comportamiento del usuario desde un sitio hasta 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, se debe configurar _setAllowLinker() como true en la página web de destino para que la vinculación funcione.

Parámetros

HTMLFormElement   formObject Objeto de formulario que encapsula la solicitud POST.

Boolean   useHash Se establece como verdadero para pasar las variables de código de seguimiento mediante el separador # de etiquetas de anclaje en lugar del valor predeterminado? separador de cadenas de consulta.

_setAllowHash()

_setAllowHash(bool)

Configura la marca de hash del dominio permitido. De forma predeterminada, este valor se establece en true. La función de hash del dominio en Google Analytics crea un valor de hash a partir 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 deseas realizar un seguimiento del comportamiento del usuario en ambos subdominios, debes desactivar el hash de dominio para que la verificación de integridad de la cookie no rechace una cookie de usuario que provenga de un dominio a otro. Además, puedes desactivar esta función para optimizar el rendimiento del seguimiento por página.

Parámetros

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

_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, de modo que este utilice los datos de cookies del parámetro de URL, en lugar de la lógica de sesión estándar.

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

Parámetros

El valor predeterminado de Boolean  true o false 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 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 de los usuarios está restringido solo a un subdirectorio de un dominio, este método puede resolver problemas de seguimiento configurando un subdirectorio como la ruta predeterminada para todo el seguimiento.

Por lo general, se usa si no se realiza un seguimiento de tus datos y si 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 Nueva ruta de acceso de cookie para configurar.

_setDomainName()

_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 según la propiedad document.domain del DOM.

Cómo especificar un dominio

Consulta la Guía de seguimiento multidominio para ver una variedad de 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']);

Aísla dominios de nivel superior

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

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

Parámetros

String   newDomainName Nuevo nombre de dominio predeterminado para configurar.

_storeGac(bool)

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

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