Código de seguimiento: configuración básica

En esta referencia, se describen los métodos que puedes usar para personalizar todos los aspectos de los informes de Google Analytics.

Métodos básicos de ga.js

Detalles del método

_deleteCustomVar()

_deleteCustomVar(index)

Este método borra la variable asignada al índice proporcionado, si existe. Por ejemplo, puedes establecer una variable personalizada a nivel del visitante y, luego, decidir que ya no deseas utilizarla.

Fragmento asíncrono (recomendado)

_gaq.push(['_deleteCustomVar', 1]);

Parámetros

Int   index Es el índice de la variable personalizada que se borrará.

_getName()

_getName()

Muestra el nombre que se le asignó al rastreador cuando se creó.

Fragmento asíncrono (recomendado)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

resultados

String: Es el nombre del dispositivo de rastreo.

_getAccount()

_getAccount()

Muestra el ID de Google Analytics de este objeto de seguimiento. Si realizas un seguimiento de páginas de tu sitio web en varias cuentas, puedes usar este método para determinar la cuenta asociada con un objeto de seguimiento en particular.

Fragmento asíncrono (recomendado) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

resultados

String ID de cuenta con el que se crea una instancia del objeto de seguimiento.

_getVersion()

_getVersion()

Muestra el número de versión de GATC.

Fragmento asíncrono (recomendado) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

resultados

String Número de versión de GATC.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

Muestra el valor de la variable personalizada a nivel del visitante asignado para el índice especificado.

Fragmento asíncrono (recomendado) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

Parámetros

Int   index Es el índice de la variable personalizada a nivel del visitante.

resultados

String Es el valor de la variable personalizada a nivel del visitante. El resultado es "indefinido" si no se puede recuperar la variable para el índice especificado.

_initData()

_initData()Obsoleto. Ahora initData() se ejecuta automáticamente en el código de seguimiento ga.js.

Inicializa o vuelve a inicializar el objeto GATC (código de seguimiento de Google Analytics).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Se usa exclusivamente en el seguimiento asíncrono. Establece el ID de propiedad web del objeto de seguimiento.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

Parámetros

String accountID: Es el ID completo de la propiedad web (p.ej., UA-65432-1) del objeto de seguimiento.

_setCookiePersistent()

_setCookiePersistence(milliseconds)

Este método dejó de estar disponible. En su lugar, usa _setVisitorCookieTimeout(cookieTimeoutMillis).

Establece el vencimiento de las cookies de visitantes de Google Analytics en milisegundos. De forma predeterminada, la cookie del visitante está configurada para vencer en 2 años. Si lo prefieres, puedes cambiar la fecha de vencimiento de la cookie del visitante con este método. Por ejemplo, para establecer el vencimiento de la cookie del visitante en 7 días, usarías el siguiente código:

pageTracker._setCookiePersistence(604800000);

Parámetros

Number   milliseconds Fecha de vencimiento de la cookie del visitante nuevo.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Establece una variable personalizada con el nombre, el valor y el alcance proporcionados para la variable. Hay un límite de caracteres de 128 bytes para name y value combinados.

Fragmento asíncrono (recomendado) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

resultados

Boolean Este método muestra true si la variable personalizada se configuró correctamente y false si no lo ha hecho (p.ej., si la longitud de la string de nombre/valor supera los 128 bytes o si usas una ranura incorrecta).

Parámetros

Int      index       Obligatorio. Es el espacio que se usa para la variable personalizada. Los valores posibles son 1-5, inclusive.

String   name        Obligatorio. Es el nombre de la variable personalizada.

String   value       Obligatorio. Es el valor de la variable personalizada.

Int      opt_scope   Opcional. Es el alcance utilizado para la variable personalizada. Los valores posibles son 1 para el nivel de visitante, 2 para el nivel de sesión y 3 para el nivel de página.

_setSampleRate()

_setSampleRate(newRate)

Establece la tasa de muestreo nueva. Si tu sitio web es particularmente grande y está sujeto a aumentos repentinos de tráfico intensos, configurar la tasa de muestreo garantizará que se realice un seguimiento de los informes sin interrupciones. El muestreo en Google Analytics se realiza de forma constante con respecto a los visitantes únicos, por lo que hay integridad en las tendencias y en los informes, incluso cuando el muestreo está habilitado, ya que estos últimos permanecen incluidos o excluidos de la muestra, según lo establecido al iniciar el muestreo.

Solo necesitas especificar este método al mismo tiempo que se llama a _setAccount(), generalmente una vez por página o aplicación (donde sea que inicialices el código de seguimiento). Ten en cuenta que el valor de la tasa de muestreo que especifiques seguirá vigente mientras persista el objeto de seguimiento.

Fragmento asíncrono (recomendado) 

_gaq.push(['_setSampleRate', '2.5']);

Parámetros

String newRate: Se establecerá la nueva tasa de muestreo. Proporciona una cadena numérica entre 0 y 100 (precisa hasta dos decimales).

_setSessionTiempo de espera()

_setSessionTimeout(newTimeout)

Este método dejó de estar disponible. En su lugar, usa _setSessionCookieTimeout(cookieTimeoutMillis).

Establece el nuevo tiempo de espera de la sesión en segundos. De forma predeterminada, el tiempo de espera de la sesión se establece en 30 minutos (1,800 segundos). El tiempo de espera de la sesión se utiliza para calcular las visitas (consulta Cómo se define una sesión en Analytics). Si deseas cambiar la definición de "sesión" según tus necesidades particulares, puedes pasar la cantidad de segundos para definir un valor nuevo. Esto afectará los informes de visitas en cada sección donde se calcula la cantidad de visitas y donde se usan las visitas para calcular otros valores. Por ejemplo, la cantidad de visitas suele aumentar si reduces el tiempo de espera de la sesión y, en general, disminuirá si lo aumentas.

Parámetros

String newTimeout Nuevo tiempo de espera de la sesión que se establecerá en segundos.

_setSessionCookieTiempo de espera()

_setSessionCookieTimeout(cookieTimeoutMillis)

Establece el nuevo tiempo de espera de las cookies de sesión en milisegundos. De forma predeterminada, el tiempo de espera de la sesión se establece en 30 minutos. El tiempo de espera de la sesión se utiliza para calcular las visitas, ya que una visita finaliza después de 30 minutos de inactividad del navegador o cuando se cierra el navegador. Si quieres cambiar la definición de “sesión” según tus necesidades particulares, puedes pasar la cantidad de milisegundos para definir un valor nuevo. Esto afectará los informes de visitas en cada sección donde se calcula la cantidad de visitas y donde se utilizan las visitas para calcular otros valores. Por ejemplo, el número de visitas aumentará si reduces el tiempo de espera de la sesión y disminuirá si lo aumentas. Puede cambiar el tiempo de espera de caducidad a 0 para indicar que esta cookie debe eliminarse cuando se cierra el navegador.

Fragmento asíncrono (recomendado) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


Parámetros

Number cookieTimeoutMillis Nuevo tiempo de espera de la sesión en milisegundos o 0 para eliminar la cookie cuando se cierra el navegador.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Define un nuevo tamaño del conjunto de muestras para la recopilación de datos del tipo Velocidad del sitio. De forma predeterminada, el grupo de datos del que se derivan las métricas de Velocidad del sitio es una muestra fija del 1% de los visitantes de tu sitio. Si tienes una cantidad relativamente pequeña de visitantes diarios en tu sitio, como 100,000 o menos, te recomendamos ajustar el muestreo a una tasa más alta. Esto proporcionará un mayor nivel de detalle para el tiempo de carga de la página y otras métricas de Velocidad del sitio. (Consulta Velocidad del sitio en el Centro de ayuda para obtener detalles sobre los informes Velocidad del sitio).

Se debe llamar al método _setSiteSpeedSampleRate() antes de _trackPageview() para que sea eficaz.

Analytics restringe los hits de la recopilación de datos del sitio para una sola propiedad a más del 1% de los usuarios o a los 10,000 hits por día, a fin de garantizar una distribución equitativa de los recursos del sistema para esta función.

Nota: Recomendamos que los sitios con más de 1 millón de hits por día mantengan la selección de muestras en la tasa predeterminada del 1%. Ajustar el tamaño de la muestra a un número mayor no aumentará el tamaño de tu muestra.

Fragmento asíncrono (recomendado) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

Parámetros

Number sampleRate Es un valor entre 0 y 100 para definir el porcentaje de visitantes de tu sitio que se medirá con el objetivo de mejorar la velocidad del sitio. Por ejemplo, un valor de 5 establece la muestra de la colección Velocidad del sitio en 5%.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Establece el vencimiento de las cookies de visitantes de Google Analytics en milisegundos. De forma predeterminada, la cookie del visitante está configurada para vencer en 2 años. Si lo prefieres, puedes cambiar la fecha de vencimiento de la cookie del visitante con este método. Puedes cambiar el tiempo de espera de vencimiento a 0 para indicar que esta cookie debe borrarse cuando se cierra el navegador.

Fragmento asíncrono (recomendado) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

Parámetros

Number cookieTimeoutMillis Nuevo tiempo de vencimiento de la cookie del visitante en milisegundos o 0 para borrarla cuando se cierra el navegador.

_setVar().

_setVar(newVal)

Este método dejó de estar disponible. En su lugar, utiliza _setCustomVar().

Establece o define un segmento de visitantes personalizado con la cadena proporcionada. Puedes utilizar este valor para proporcionar segmentación adicional a los usuarios de tu sitio web. Por ejemplo, puedes tener una página de acceso o un formulario que active un valor basado en la entrada del visitante, como una preferencia que elija, o una opción de privacidad. Luego, esta variable se actualiza en la cookie para ese visitante. Cuando se implementa en tu sitio y los datos se recopilan mediante este método, el segmento definido recientemente aparece en los informes Definido por el usuario, en la sección Visitantes de los informes de Analytics. Además, puedes acceder al segmento Valor definido por el usuario en el informe de detalles del contenido para ver qué porcentaje de visitantes de una página pertenece a un segmento específico que defines.

Parámetros

String newVal Es el valor definido por el usuario nuevo para establecer.

_trackPageLoadTime()

_trackPageLoadTime()

Este método dejó de estar disponible porque los informes de velocidad del sitio se habilitan automáticamente para todos los usuarios. Utiliza _setSiteSpeedSampleRate() para ajustar la tasa de muestreo de los informes Velocidad del sitio.

Habilita los informes de Velocidad del sitio para esta página. Inserta este método en cada página de tu sitio para la que deseas generar informes sobre la velocidad del sitio. Para obtener más información sobre los informes Velocidad del sitio en Analytics, consulta el artículo Velocidad del sitio en nuestro Centro de ayuda.

Verificación de los cambios

Si ves datos en los informes, significa que la configuración es correcta. Si no ves datos después de 24 horas, verifica la personalización para asegurarte de que no cometiste errores. Consulta Solución de problemas del código de seguimiento para obtener una lista de errores comunes del código de seguimiento. En esta guía para solucionar problemas, también se incluyen Pasos básicos de depuración y más información sobre la depuración.

Ten en cuenta que habilitar el seguimiento de la velocidad del sitio para tu sitio generará una solicitud adicional a los servidores de Google Analytics, separada de la solicitud de GIF de seguimiento de página realizada para las vistas de página. Para minimizar el impacto en la latencia general del sitio, esta solicitud se envía solo en una muestra de las vistas de página de tu sitio. Por este motivo, es posible que no siempre veas la solicitud de GIF de velocidad del sitio cuando intentes depurar esta función en Firebug u otras herramientas. Esto es normal y esperable.

Fragmento asíncrono (recomendado) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Lógica principal de GATC (código de seguimiento de Google Analytics). Si las funciones del vinculador están habilitadas, intenta extraer los valores de cookies de la URL. De lo contrario, intentará extraer los valores de cookies de document.cookie. También actualiza o crea cookies según sea necesario y, luego, las vuelve a escribir en el objeto del documento. Recopila todas las métricas adecuadas para enviar a la UCFE (frontend del recopilador de Urchin).

Fragmento asíncrono (recomendado) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

Parámetros

String opt_pagePath Es un parámetro opcional para indicar la ruta de la página en la que se realizará el seguimiento de las métricas. Si usas esta opción, utiliza una barra diagonal (/) inicial para indicar la ruta de la página.