Identificación de usuarios y cookies con gtag.js

La etiqueta gtag.js utiliza cookies para identificar a los usuarios únicos en las sesiones de navegación. En esta página se explica cómo personalizar la configuración de cookies.

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

Nombre del campo Tipo de valor Valor predeterminado
cookie_domain string auto
cookie_expires integer 63072000 (dos años, en segundos)
cookie_prefix string _ga
cookie_update boolean true
cookie_flags string

Para cambiar cualquiera de estos valores, actualiza el config de tu propiedad a fin de especificarlos en la lista de parámetros. Por ejemplo:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

De forma predeterminada, gtag.js tiene habilitada la configuración automática del dominio de las cookies. Cuando se habilite, gtag.js establecerá cookies en el dominio de nivel más alto posible. Por ejemplo, si la dirección de tu sitio web es blog.example.com, gtag.js establecerá cookies en el dominio example.com. Si gtag.js detecta que estás ejecutando un servidor de forma local (p.ej., localhost), establece automáticamente cookie_domain en 'none', lo que hará que gtag.js establezca cookies con el dominio completo de la ubicación del documento.

Para desactivar la configuración automática del dominio de cookies, actualiza el archivo config de tu propiedad a fin de especificar un valor para el parámetro cookie_domain:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

Para evitar conflictos con otras cookies, es posible que debas cambiar el prefijo de las cookies, que se antepondrá a las cookies establecidas por gtag.js. Por ejemplo, el nombre predeterminado de la cookie de ID que usa Google Analytics es _ga. Este código hará que la cookie se llame example_ga en su lugar:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

En cada carga de página, la hora de vencimiento de la cookie se actualiza para que sea la hora actual más el valor del campo cookie_expires. Esto significa que si cookie_expires se establece en una semana y un usuario visita la página con el mismo navegador en un plazo de cinco días, la cookie estará disponible durante una semana adicional y aparecerá como el mismo visitante en Google Analytics. Si ese mismo usuario visitó el sitio después de que venció la cookie original, se creará una cookie nueva, y su primera y segunda visita aparecerán como provenientes de diferentes visitantes en Google Analytics.

Si estableces el valor cookie_expires en 0 (cero) segundos, la cookie se convierte en una cookie basada en sesión y vence una vez que finaliza la sesión actual del navegador.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

Cuando cookie_update se establece en true (el valor predeterminado), gtag.js actualizará las cookies en cada carga de página. Esto actualizará el vencimiento de la cookie que 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.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

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

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

Configurar ID de usuario

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

Si deseas implementar el ID de usuario con gtag.js, actualiza el archivo config de tu propiedad para configurarlo:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

Puedes configurar gtag.js para que no lea ni escriba cookies hasta que se otorgue el consentimiento del usuario. Para obtener más información, consulte Cómo ajustar el comportamiento de las etiquetas según el consentimiento.