Crear objetos de seguimiento

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Los objetos de seguimiento pueden recopilar y almacenar datos y, después, enviarlos a Google Analytics.

Al crear un objeto de seguimiento, debes especificar un ID de seguimiento (que es lo mismo que el ID de propiedad en tus propiedades de Google Analytics), así como un dominio de cookies, que especifica cómo se almacenan las cookies. El valor recomendado 'auto' especifica la configuración automática de dominios de cookies.

Si no existe una cookie correspondiente al dominio especificado, se genera un ID de cliente que se almacena en la cookie y el usuario se identifica como nuevo. Si hay una cookie que contiene un valor de ID de cliente, dicho ID se incluye en el objeto de seguimiento y el usuario se identifica como recurrente.

Cuando se crea un objeto de seguimiento, también se recopila información sobre el contexto de navegación actual, como el título y la URL de la página, además de datos sobre el dispositivo, como la resolución de pantalla, el tamaño de ventana gráfica y la codificación de documentos. Cuando llega el momento de enviar los datos a Google Analytics, se envía la información almacenada actualmente en el objeto de seguimiento.

Método create

La biblioteca analytics.js proporciona distintas formas de crear objetos de seguimiento, pero la más habitual consiste en usar el comando create y usar los campos de ID de seguimiento y dominio de cookies como los parámetros segundo y tercero:

ga('create', 'UA-XXXXX-Y', 'auto');

Asignar nombres a los objetos de seguimiento

También puedes asignar un nombre al objeto de seguimiento usando el campo name como cuarto argumento del comando create. Si tienes que crear varios objetos de seguimiento para una misma página, deberás asignarles nombres. Si quieres obtener más información sobre los motivos por los que puede ser necesario hacerlo, consulta la sección sobre cómo trabajar con varios objetos de seguimiento que aparece más abajo.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

A la acción de crear un objeto de seguimiento sin configurar el campo name se le denomina "crear un objeto de seguimiento predeterminado". A este tipo de objetos se le asigna internamente el nombre "t0".

Especificar los campos en el momento de la creación

También se puede usar un objeto fields opcional que permita configurar los campos de analytics.js en el momento en que se crean, por lo que se almacenarán en el objeto de seguimiento y se aplicarán a todos los hits que se envíen.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

Del mismo modo que con las llamadas a la función ga(), el objeto fields también se puede usar para especificar todos los campos a la vez:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto',
  name: 'myTracker',
  userId: '12345'
});

Puedes consultar la referencia del método create para obtener más información.

Trabajar con varios objetos de seguimiento

En algunos casos es recomendable enviar los datos a varias propiedades desde una sola página. Esto resulta útil para sitios web que tienen varios propietarios que supervisan determinadas secciones de un sitio web; cada propietario podría ver su propiedad.

Para realizar el seguimiento de los datos de dos propiedades independientes, se deben crear dos objetos de seguimiento independientes y al menos uno de ellos debe tener nombre. Con los dos comandos siguientes se crea un objeto de seguimiento predeterminado y otro con el nombre "clientTracker":

ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');

Ejecutar comandos para determinados objetos de seguimiento

Si quieres ejecutar comandos de analytics.js para un determinado objeto de seguimiento, escribe el nombre del objeto de seguimiento y un punto delante del nombre del comando. Si no se especifica el nombre de un objeto de seguimiento concreto, el comando se ejecuta en el objeto predeterminado.

Para enviar las páginas vistas de los dos objetos de seguimiento, se deben ejecutar los dos comandos siguientes:

ga('send', 'pageview');
ga('clientTracker.send', 'pageview');

En próximas guías se profundizará en la sintaxis para ejecutar determinados comandos. También puedes consultar la sintaxis completa de todos los comandos de analytics.js en la referencia de la cola de comandos.

Pasos siguientes

Una vez creado un objeto de seguimiento, es posible que debas acceder a los datos almacenados en ese objeto de seguimiento. En la guía siguiente se explica cómo obtener y configurar los datos de los objetos de seguimiento.