Cookies e identificación de usuarios

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

La biblioteca analytics.js logra esto mediante el campo ID de cliente, una cadena única generada de forma aleatoria que se almacena en las cookies del navegador, de modo que las visitas posteriores al mismo sitio se puedan asociar con el mismo usuario.

De forma predeterminada, analytics.js usa una sola cookie propia llamada _ga para almacenar el ID de cliente, pero el nombre, el dominio y la fecha de vencimiento de la cookie se pueden personalizar. Entre otras cookies que crea analytics.js, se incluyen _gid, AMP_TOKEN y _gac_<property-id>. Estas cookies almacenan otros IDs generados al azar y también información de la campaña sobre el usuario.

El uso de cookies permite que analytics.js identifique a usuarios únicos en distintas sesiones de navegación, pero no puede identificar a usuarios únicos en diferentes navegadores o dispositivos. Si tu sitio tiene su propio sistema de autenticación, puedes usar la función User-ID, además del ID de cliente, para identificar con mayor precisión a un usuario en todos los dispositivos que utiliza para acceder a tu sitio.

En esta guía, se explica cómo personalizar la configuración de cookies y cómo establecer el campo de ID del usuario para medir con mayor precisión la actividad del usuario en todas las sesiones.

Nota: Puedes consultar la guía Uso de cookies para obtener más información sobre cómo analytics.js usa las cookies.

Configuración del campo de cookies

En la siguiente tabla, se muestran los valores predeterminados del campo de cookies que usa analytics.js:

Nombre del campo	Value Type	Valor predeterminado
cookieName	text	_ga
cookieDomain	text	El resultado de la siguiente expresión de JavaScript: document.location.hostname
cookieExpires	integer	63072000 (dos años, en segundos)
cookieUpdate	boolean	true
cookieFlags	text

Para modificar cualquiera de estos valores, puedes especificarlos en el fieldObject, pasa 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 cookies más común para establecer es cookieDomain. Por lo tanto, el comando create acepta el campo cookieDomain como un tercer parámetro opcional por conveniencia:

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

Precaución: cookieDomain debe ser un elemento principal del dominio actual; de lo contrario, la cookie no se establecerá. Por ejemplo, si el dominio es one.two.three.root.com, puedes configurar la cookie para que se establezca en root.com, pero no en someotherdomain.com. Si se configura un dominio de cookies incorrecto, no se enviarán hits a Google Analytics.

Configuración automática del dominio de cookies

La etiqueta recomendada de Google Analytics establece la cadena 'auto' para el campo cookieDomain:

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

Especificar 'auto' como cookieDomain habilita la configuración automática del dominio de cookies, lo que le indica a analytics.js que determine automáticamente el mejor dominio de cookies para usar.

La configuración automática del dominio de cookies establece la cookie _ga en el dominio de nivel más alto que pueda. Por ejemplo, si la dirección de tu sitio web es blog.example.co.uk, analytics.js establecerá el dominio de cookies en .example.co.uk. Además, si analytics.js detecta que estás ejecutando un servidor de manera local (p.ej., localhost), configurará automáticamente cookieDomain como 'none'.

Cuando se utiliza la configuración automática del dominio de cookies, la actividad del usuario se medirá en los subdominios sin ninguna configuración adicional.

Vencimiento de las cookies

Cada vez que se envía un hit a Google Analytics, la hora de vencimiento de la cookie se actualiza para que sea la hora actual más el valor del campo cookieExpires. Esto significa que, si usas el tiempo predeterminado cookieExpires de dos años y un usuario visita tu sitio todos los meses, su cookie nunca vencerá.

Si estableces el tiempo de cookieExpires en 0 (cero) segundos, la cookie se convertirá en una cookie basada en sesión y vencerá una vez que finalice la sesión actual del navegador:

Precaución: Si configuras la cookie para que venza demasiado rápido, aumentarás el recuento de usuarios y disminuirás la calidad de tus mediciones.

Actualización de cookies

Cuando cookieUpdate se establece en true (el valor predeterminado), analytics.js actualizará las cookies en cada carga de página. Esto actualizará el vencimiento de la cookie y se establecerá en relación con la visita más reciente al sitio. Por ejemplo, si el vencimiento de la cookie se establece en una semana y un usuario visita con el mismo navegador cada cinco días, el vencimiento de la cookie se actualizará en cada visita y, por lo tanto, nunca vencerá.

Cuando se configura en false, las cookies no se actualizan en cada carga de página. Esto tiene el efecto de que el vencimiento de la cookie sea relativo a la primera vez que un usuario visitó el sitio.

Marcas de cookies

Agrega marcas adicionales a la cookie cuando se configura. Las marcas deben estar separadas por punto y coma.

Precaución: Si configuras samesite como None y omites la marca Secure o publiques el sitio a través de HTTP, la medición se verá afectada.

Cómo obtener el ID de cliente de la cookie

No debes acceder directamente a los conjuntos de analytics.js de cookies, ya que el formato de la cookie podría cambiar en el futuro. En cambio, los desarrolladores deben usar readyCallback para esperar hasta que se cargue analytics.js y, luego, obtener el valor clientId almacenado en la herramienta de seguimiento.

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

Cómo inhabilitar las cookies

En algunos casos, es posible que desees usar tu propio mecanismo de almacenamiento (como localStorage o un Service Worker) para conservar el ID de cliente en todas las sesiones sin usar cookies. Para inhabilitar la configuración de cookies de analytics.js, configura el campo storage como 'none'.

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

Si almacenas el campo clientId por tu cuenta, deberás asegurarte de configurar el campo cliendId cuando crees la herramienta de seguimiento.

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

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

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

Usa localStorage para almacenar el ID de cliente

En la siguiente muestra de código, se indica cómo modificar la etiqueta de JavaScript para usar localStorage y así almacenar el ID de cliente en lugar de 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');

Precaución: A diferencia de las cookies, localStorage está sujeto a la política del mismo origen . Si partes de tu sitio están en subdominios diferentes, o si algunas páginas usan http y otras usan https, no puedes usar localStorage para medir la actividad del usuario entre esas páginas. Por este motivo, las cookies siguen siendo la forma oficial recomendada de almacenar el ID de cliente.

ID de usuario

User-ID permite analizar grupos de sesiones en varios dispositivos mediante una string de ID que representa a un usuario y es única, persistente y no proporciona identificación personal. Para obtener información sobre por qué deberías implementar el User-ID, consulta Beneficios de usar la función User-ID.

Para implementar el ID de usuario con analytics.js, sigue estos pasos:

1. Proporciona tu propio ID de cadena único, persistente y que no permita identificarte de manera personal para representar a cada usuario que accedió. Este ID lo proporciona la mayoría de las veces un sistema de autenticación.
2. Configura el ID de usuario en el rastreador:

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

Precaución: El valor USER_ID debe ser un identificador de cadena único, persistente y no personal que represente a un usuario o a una cuenta que accedió en varios dispositivos.

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

Cuando compilas aplicaciones de una sola página o algún otro sitio web dinámico que controla el acceso del usuario después de la carga inicial de la página, el proceso de configuración del valor del ID de usuario en la herramienta de seguimiento no puede ocurrir en el momento de la creación.

En esos casos, puedes usar el comando set para establecer el valor en el rastreador en cuanto 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');

Cuando se utiliza este enfoque, los hits enviados antes de que se establezca el campo userId no contendrán valores de ID de usuario. Sin embargo, mediante un proceso conocido como unificación de sesión, Google Analytics puede asociar estos hits con el usuario correcto en el momento del procesamiento.