Cómo crear herramientas de seguimiento

Los objetos de rastreadores (también conocidos como "herramientas de seguimiento") son objetos que pueden recopilar y almacenar datos y, luego, enviarlos a Google Analytics.

Cuando crees una herramienta de seguimiento nueva, debes especificar un ID de seguimiento (que es el mismo que el ID de propiedad correspondiente a una de tus propiedades de Google Analytics) y un dominio de cookies, que especifica cómo se almacenan las cookies. (El valor recomendado 'auto' especifica la configuración automática del dominio de cookies).

Si no existe una cookie para el dominio especificado, se genera un ID de cliente y se almacena en ella, y el usuario se identifica como nuevo. Si existe una cookie que contiene un valor de ID de cliente, ese ID se establece en la herramienta de seguimiento y el usuario se identifica como recurrente.

Cuando se crean, 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, y sobre el dispositivo, como la resolución de pantalla, el tamaño de la vista del puerto y la codificación del documento. Cuando llegue el momento de enviar datos a Google Analytics, se enviará toda la información almacenada actualmente en el dispositivo de seguimiento.

El método create

La biblioteca analytics.js proporciona varias formas de crear herramientas de seguimiento, pero la más común es usar el comando create y pasar los campos ID de seguimiento y dominio de cookies como segundo y tercer parámetro:

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

Asigna un nombre a los rastreadores

De manera opcional, también puedes nombrar la herramienta de seguimiento. Para ello, pasa el campo name como el cuarto argumento en el comando create. Es necesario asignar un nombre a un rastreador en los casos en los que necesites crear más de un rastreador para la misma página. Para obtener más detalles sobre por qué necesitas hacer esto, consulta la sección a continuación sobre cómo trabajar con varios segmentos.

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

La creación de un segmento sin configurar el campo name se conoce como crear un segmento "predeterminado". A un rastreador predeterminado se le asigna internamente el nombre "t0".

Especifica los campos en el momento de la creación

Es posible que también se pase un objeto de campos opcional que le permita configurar cualquiera de los campos de analytics.js en el momento de su creación, de modo que se almacenarán en la herramienta de seguimiento y se aplicarán a todos los hits que se envíen.

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

Al igual que con todas las llamadas a la función ga(), el objeto de campos también se puede usar para especificar todos los campos juntos:

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

Consulta la referencia del método create para obtener información más detallada.

Cómo trabajar con varios monitores

En algunos casos, es posible que desees enviar datos a varias propiedades desde una sola página. Esto es útil para los sitios que tienen varios propietarios que supervisan las secciones de un sitio; cada propietario puede ver su propia propiedad.

Para realizar un seguimiento de los datos de dos propiedades separadas, debes crear dos segmentos separados y al menos uno de ellos debe ser uno con nombre. Los siguientes dos comandos crean un rastreador predeterminado y uno llamado "clientTracker":

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

Cómo ejecutar comandos para un rastreador específico

Si quieres ejecutar los comandos de analytics.js para un rastreador específico, debes agregar el prefijo del nombre del comando al nombre del rastreador, seguido de un punto. Cuando no especificas un nombre de seguimiento, el comando se ejecuta en el rastreador predeterminado.

Para enviar vistas de página de los dos segmentos anteriores, debes ejecutar los siguientes dos comandos:

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

En las guías futuras, se detallará la sintaxis para ejecutar comandos específicos. También puedes consultar la referencia de la cola de comandos para ver la sintaxis completa de todos los comandos analytics.js.

Próximos pasos

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