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

En esta referencia, se describen los métodos que utiliza 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, puede configurar una variable personalizada a nivel del visitante y, luego, decidir que ya no desea usarla.

Fragmento asíncrono (recomendado)

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

Parámetros

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


_getName()

_getName()

Muestra el nombre que se le dio 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 El nombre del monitor.


Obtener cuenta()

_getAccount()

Muestra el ID de Google Analytics de este objeto de seguimiento. Si realizas un seguimiento de las páginas de tu sitio web en varias cuentas, puedes utilizar 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: Es el ID de la cuenta con la que se crean instancias de este objeto de seguimiento.


Versión_get

_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

Número de versión de GATC de String.


_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. Muestra undefined si no 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();

Cuenta_()

_setAccount(accountId)

Se usa exclusivamente en el seguimiento asíncrono. Configura el ID de propiedad web para el objeto de seguimiento.

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

Parámetros

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


_setCookiePersistence()

_setCookiePersistence(milliseconds)

Este método es obsoleto. En su lugar, usa _setVisitorCookieTimeout(cookieTimeoutMillis).

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

pageTracker._setCookiePersistence(604800000); 

Parámetros

Number   milliseconds Hora de vencimiento de la cookie nueva para el visitante


_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 128 bytes para los caracteres name y value combinados.

Fragmento asíncrono (recomendado)

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

resultados

Boolean Este método muestra true si se configuró correctamente la variable personalizada y false si no se configuró correctamente (p.ej., si la longitud de la string de nombre/valor supera los 128 bytes o si utiliza 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. 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.


Tasa de muestra

_setSampleRate(newRate)

Establece la nueva tasa de muestreo. Si su sitio web es particularmente grande y está sujeto a picos de tráfico intensos, configurar la tasa de muestreo asegura el seguimiento ininterrumpido de los informes. El muestreo en Google Analytics se produce de manera coherente entre los visitantes únicos, por lo que hay integridad en las tendencias y los informes, incluso cuando se habilita el muestreo, ya que los visitantes únicos permanecen incluidos en la muestra o se excluyen de ella, según se establece desde el inicio del muestreo.

Solo debe especificar este método al mismo tiempo que se llama a _setAccount(), por lo general, una vez por página o aplicación (donde sea que inicialice el código de seguimiento). Tenga en cuenta que el valor de la tasa de muestreo que especifique se mantendrá vigente mientras el objeto de seguimiento persista.

Fragmento asíncrono (recomendado)

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

Parámetros

String newRate Nueva tasa de muestreo para configurar. Proporciona una string numérica entre 0 y 100 (precisa en dos decimales).


_setSessionTimeout()

_setSessionTimeout(newTimeout)

Este método es obsoleto. En su lugar, usa _setSessionCookieTimeout(cookieTimeoutMillis).

Establece el tiempo de espera de la sesión nueva 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 usa para calcular las visitas (consulta Cómo se define una sesión en Analytics). Si deseas cambiar la definición de una “sesión” según tus necesidades particulares, puedes pasar la cantidad de segundos para definir un valor nuevo. Esto afectará a los informes de visitas en todas las secciones en las que se calcula la cantidad de visitas y en las que se usan para calcular otros valores. Por ejemplo, la cantidad de visitas suele aumentar si se reduce el tiempo de espera de la sesión y, en general, si se aumenta el tiempo de espera de la sesión.

Parámetros

String newTimeout Se agotó el tiempo de espera de la nueva sesión en segundos.


_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Establece el tiempo de espera de la nueva cookie 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 usa para calcular las visitas, ya que una visita termina después de 30 minutos de inactividad del navegador o al salir del navegador. Si deseas cambiar la definición de una "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 todas las secciones en las que se calcula la cantidad de visitas y en las que se usan para calcular otros valores. Por ejemplo, la cantidad de visitas aumentará si reduce el tiempo de espera de la sesión y si aumenta el tiempo de espera de la sesión. 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 Es el tiempo de espera nuevo de la sesión en milisegundos o 0 para borrar la cookie cuando se cierra el navegador.


_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Define un nuevo tamaño del conjunto de muestra para la recopilación de datos de velocidad del sitio. De forma predeterminada, un grupo de datos del que se derivan las métricas de velocidad del sitio corresponde al muestreo fijo 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 mayor. 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 de Velocidad del sitio).

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

Analytics restringe los hits de la recopilación de velocidad del sitio de una sola propiedad al 1% más alto de usuarios o a 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 enfáticamente que los sitios con más de 1 millón de hits por día mantengan la selección de muestra establecida en una tasa predeterminada del 1%. Ajustar el tamaño de la muestra a un número mayor no aumentará el tamaño de la muestra.

Fragmento asíncrono (recomendado)

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

Parámetros

Number sampleRate Valor entre 0 y 100 que define el porcentaje de visitantes de tu sitio que se medirá para medir la velocidad del sitio Por ejemplo, un valor de 5 establece la muestra de la recopilación de velocidad del sitio en un 5%.


_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Establece la caducidad de la cookie del visitante 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 Es el tiempo de caducidad de la cookie nueva del visitante en milisegundos o 0 para borrarla cuando el navegador está cerrado.


_setVar()

_setVar(newVal)

Este método es obsoleto. En su lugar, utiliza _setCustomVar().

Establece o define un segmento de visitante personalizado con la string proporcionada. Puede utilizar este valor para proporcionar una segmentación adicional de los usuarios a su sitio web. Por ejemplo, puedes tener una página de acceso o un formulario que active un valor en función de la entrada de un visitante, como una preferencia o una opción de privacidad. Luego, esta variable se actualiza en la cookie para ese visitante. Cuando se implementa en su sitio y los datos se recopilan a través de este método, el segmento recientemente definido aparece en los informes Definidos 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 en particular que tú defines.

Parámetros

String newVal Es el valor nuevo que define el usuario.


_trackPageLoadTime().

_trackPageLoadTime()

Este método es obsoleto porque los informes de velocidad del sitio están habilitados automáticamente para todos los usuarios. Usa _setSiteSpeedSampleRate() para ajustar la tasa de muestreo de los informes sobre la velocidad del sitio.

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

Verifica los cambios

Si ves datos en los informes, la configuración es correcta. Si no ves ningún dato después de 24 horas, verifica tu personalización para asegurarte de que no haya errores. Consulte Solución de problemas relacionados con el código de seguimiento para obtener una lista de errores comunes de códigos de seguimiento. En esta guía de solución de problemas, también se incluyen Pasos básicos para la depuración y más información sobre la depuración.

Tenga en cuenta que si habilita el seguimiento de la velocidad del sitio para su sitio, se enviará una solicitud adicional a los servidores de Google Analytics, aparte de la solicitud de seguimiento de la página para GIF. Para minimizar el impacto en la latencia general del sitio, esta solicitud se envía solo en una muestra de las páginas vistas 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 o en otras herramientas. Esto es normal y esperado.

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 funcionalidades del vinculador están habilitadas, intenta extraer valores de cookies de la URL. De lo contrario, intentará extraer 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 de colector de Urchin).

Fragmento asíncrono (recomendado)

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

Parámetros

String opt_pagePath: Es el parámetro opcional para indicar la ruta de la página en la que se realiza el seguimiento de las métricas. Cuando uses esta opción, usa una barra diagonal (/) para indicar la ruta de la página.