Cookies e identificación de usuarios

Para que Google Analytics determine que dos hits diferentes pertenecen al mismo usuario, con cada hit se debe enviar un identificador único asociado a ese usuario.

Para ello, la biblioteca analytics.js utiliza el campo ID de cliente, una cadena única generada aleatoriamente que se almacena en las cookies del navegador. De este modo, las visitas posteriores al mismo sitio se pueden asociar al mismo usuario.

De forma predeterminada, analytics.js usa una cookie propia llamada _ga para almacenar el ID de cliente, pero el nombre, el dominio y la hora de caducidad de la cookie se pueden personalizar. La biblioteca analytics.js también crea otras cookies, como _gid, AMP_TOKEN y _gac_<property-id>. Estas cookies almacenan otros identificadores generados de forma aleatoria e información de campaña relativa al usuario.

El uso de cookies permite a analytics.js identificar a los usuarios únicos en diferentes sesiones de navegación, pero no en diferentes navegadores o dispositivos. Si tu sitio dispone de un sistema de autenticación propio, puedes usar la función User ID, además del ID de cliente, para identificar a un usuario de un modo más preciso en todos los dispositivos que usa para acceder a tu sitio.

En esta guía se explica cómo personalizar la configuración de las cookies y cómo configurar el campo ID de usuario para medir de forma más precisa la actividad de usuario en diferentes sesiones.

Nota: consulta la guía de uso de cookies para obtener más información sobre el uso que hace analytics.js de las cookies.

Configurar los valores de los campos de cookie

En la tabla siguiente se muestran los valores predeterminados de los campos de cookie que usa analytics.js:

Nombre del campo	Tipo de valor	Valor predeterminado
cookieName	texto	_ga
cookieDomain	texto	Resultado de la siguiente expresión JavaScript: document.location.hostname
cookieExpires	entero	63072000 (dos años, en segundos)
cookieUpdate	booleano	true
cookieFlags	texto

Para cambiar cualquiera de estos valores, puedes especificarlos en el objeto fieldObject que envías en el comando create. Por ejemplo:

ga('create', 'UA-XXXXX-Y', {
  'cookieName': 'gaCookie',
  'cookieDomain': 'blog.example.co.uk',
  'cookieExpires': 60 * 60 * 24 * 28  // Time in seconds.
  'cookieUpdate': 'false',
  'cookieFlags': 'SameSite=None; Secure',
});

El campo de cookie más habitual es cookieDomain. Por eso, el comando create acepta el campo cookieDomain como tercer parámetro opcional para mayor comodidad:

ga('create', 'UA-XXXXX-Y', 'blog.example.co.uk');

Advertencia: El objeto cookieDomain debe ser un antecedente de tu dominio actual; de lo contrario, no se aplicará la cookie. Por ejemplo, si tu dominio es one.two.three.root.com, puedes definir la cookie en root.com, pero no en someotherdomain.com. Si se especifica un dominio de cookie incorrecto, no se enviarán hits a Google Analytics.

Configuración automática de dominios de cookie

La etiqueta de Google Analytics recomendada asigna la cadena 'auto' al campo cookieDomain:

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

Especificar 'auto' como cookieDomain permite que se configuren automáticamente los dominios de cookie, es decir, que analytics.js determine automáticamente el mejor dominio de cookies que se debe usar.

La configuración automática de dominios de cookie define la cookie _ga en el dominio del nivel más alto que puede. Por ejemplo, si la dirección de tu sitio web es blog.example.co.uk, analytics.js definirá .example.co.uk como dominio de las cookies. Además, si analytics.js detecta que estás ejecutando un servidor de forma local (por ejemplo, localhost), asignará automáticamente el valor 'none' a cookieDomain.

Al usar la configuración automática de dominio de las cookies, se registra la actividad de los usuarios en distintos subdominios sin tener que configurar nada más.

Caducidad de las cookies

Cada vez que se envía un hit a Google Analytics, la hora de caducidad de las cookies se actualiza para que sea la hora actual más el valor del campo cookieExpires. Es decir, si usas el tiempo predeterminado de cookieExpires de dos años y un usuario visita tu sitio cada mes, su cookie nunca caducará.

Si asignas un valor de 0 (cero) segundos a cookieExpires, la cookie se convertirá en una cookie de sesión y caducará cuando finalice la sesión de navegador en curso.

Advertencia: Si configuras la cookie para que caduque demasiado rápido, aumentará el número de usuarios y bajará la calidad de la medición.

Actualización de las cookies

Cuando se asigna el valor true (predeterminado) a cookieUpdate, analytics.js actualiza las cookies cada vez que se carga la página. De esta forma, la caducidad de las cookies cambia en función de la visita más reciente al sitio web. Por ejemplo, si a la cookie de una página se le asigna una caducidad de una semana y un usuario la visita utilizando el mismo navegador cada cinco días, la caducidad se actualiza tras cada visita y, por lo tanto, la cookie nunca caduca.

Si se asigna el valor false, las cookies no se actualizan al cargar la página, lo que implica que su caducidad se fija en función de la primera vez que un usuario visitó el sitio.

Marcas de las cookies

Añade marcas adicionales a la cookie cuando se establece. Las marcas deben estar separadas por punto y coma.

Advertencia: Asignar el valor None a samesite y omitir la marca Secure, o bien servir el sitio mediante HTTP, afectará negativamente a la medición.

Obtener el ID de cliente de la cookie

No se debe acceder directamente a la cookie que define analytics.js, ya que el formato puede cambiar más adelante. En lugar de ello, los programadores deben usar readyCallback para esperar a que se cargue analytics.js y, a continuación, obtener el valor clientId almacenado en el objeto de seguimiento.

ga(function(tracker) {
  var clientId = tracker.get('clientId');
});

Inhabilitar las cookies

En algunos casos, es mejor usar un mecanismo de almacenamiento propio (como localStorage o un service worker) para mantener el ID de cliente en varias sesiones sin usar cookies. Si quieres inhabilitar analytics.js para que no defina cookies, debes asignar el valor 'none' al campo storage.

ga('create', 'UA-XXXXX-Y', {
  'storage': 'none'
});

Si almacenas el campo clientId, no olvides definir el campo cliendId al crear el objeto de seguimiento.

ga('create', 'UA-XXXXX-Y', {
  'storage': 'none',
  'clientId': '76c24efd-ec42-492a-92df-c62cfd4540a3'
});

Para inhabilitar las cookies _gac_<property-id>, asigna el valor false al campo storeGac en el comando create:

ga('create', 'UA-XXXXX-Y', {
  storeGac: false,
});

Usar localStorage para almacenar el ID de cliente

En el siguiente código de ejemplo se muestra cómo se puede modificar la etiqueta JavaScript para usar localStorage y almacenar el ID de cliente en vez de usar cookies:

var GA_LOCAL_STORAGE_KEY = 'ga:clientId';

if (window.localStorage) {
  ga('create', 'UA-XXXXX-Y', {
    'storage': 'none',
    'clientId': localStorage.getItem(GA_LOCAL_STORAGE_KEY)
  });
  ga(function(tracker) {
    localStorage.setItem(GA_LOCAL_STORAGE_KEY, tracker.get('clientId'));
  });
}
else {
  ga('create', 'UA-XXXXX-Y', 'auto');
}

ga('send', 'pageview');

Advertencia: A diferencia de las cookies, localStorage se rige por la política del mismo origen. Si hay partes de tu sitio que se encuentran en subdominios distintos, o si en algunas páginas se usa http y en otras se usa https, no puedes utilizar localStorage para medir la actividad de los usuarios en esas páginas. Por este motivo, las cookies siguen siendo la forma recomendada oficialmente para almacenar el ID de cliente.

ID de usuario

El ID de usuario permite analizar grupos de sesiones en varios dispositivos utilizando una cadena de ID única, fija y sin información personal identificable que represente a un usuario. Para saber por qué deberías usar los ID de usuario, consulta Ventajas de usar los ID de usuario.

Para implementar la función de ID de usuario con analytics.js:

1. Proporciona un ID de cadena único, fijo y sin información personal identificable para representar a cada usuario que haya iniciado sesión. Normalmente, este ID lo proporciona un sistema de autenticación.
2. Configura el valor de ID de usuario en el objeto de seguimiento:

ga('create', 'UA-XXXXX-Y', 'auto', {
  userId: USER_ID
});
ga('send', 'pageview');

Advertencia: El valor USER_ID debe ser un identificador de cadena único, fijo y sin información personal identificable que represente a un usuario o una cuenta que haya iniciado sesión en varios dispositivos.

Gestionar la autenticación después de cargar la página

Al crear aplicaciones de página única u otros sitios web dinámicos que gestionan el inicio de sesión de los usuarios tras la carga inicial de la página, no es posible configurar el valor del ID de usuario en el objeto de seguimiento durante la creación.

En esos casos, puedes usar el comando set para definir el valor en el objeto de seguimiento tan pronto como se conozca.

// Creates the tracker and sends a pageview as normal
// since the `userId` value is not yet known.
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');

// At a later time, once the `userId` value is known,
// sets the value on the tracker.
ga('set', 'userId', USER_ID);

// Setting the userId doesn't send data to Google Analytics.
// You must also use a pageview or event to send the data.
ga('send', 'event', 'authentication', 'user-id available');

Los hits enviados antes de configurar el campo userId no incluirán valores de ID de usuario. Sin embargo, gracias a un proceso llamado unificación de sesión, Google Analytics puede asociar esos hits con el usuario correspondiente durante el procesamiento.