Crear objetos de seguimiento

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

Al crear un nuevo objeto de seguimiento, debes especificar un ID de seguimiento (que es el mismo ID de propiedad que corresponde a una de 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, se almacena en la cookie y el usuario se identifica como nuevo. Si existe una cookie que contiene un valor de ID de cliente, dicho ID se configura en el objeto de seguimiento y el usuario se identifica como recurrente.

Tras la creación, los objetos de seguimiento también recopilan 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 enviar 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 enviándole el campo name como cuarto argumento del comando create. Puede ser necesario asignar un nombre a un objeto de seguimiento en los casos en que debas crear varios objetos de ese tipo para la página. Si quieres obtener más información sobre el motivo por el que puede ser necesario hacerlo, consulta la sección siguiente sobre cómo trabajar con varios objetos de seguimiento.

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

Al hecho 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 enviar un objeto fields opcional que permita configurar los campos de analytics.js en el momento de la creación, 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

Para ejecutar los comandos de analytics.js para un determinado objeto de seguimiento, se debe anteponer al nombre del comando el del objeto de seguimiento. Si no se especifica un nombre de objeto de seguimiento, el comando se ejecuta en el predeterminado.

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

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

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

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 del objeto de seguimiento.