Envía los IDs de usuario

Los IDs de usuario son tus propios identificadores únicos que asignas a usuarios individuales. En esta guía, se explica cómo enviar IDs de usuario a Google Analytics para que puedas conectar el comportamiento del usuario en diferentes sesiones, dispositivos y plataformas.

Para obtener más información sobre la función User-ID, consulta Cómo medir la actividad en todas las plataformas. Para obtener información sobre cómo establecer un ID de usuario para una app, consulta Cómo establecer un ID de usuario.

Configurar dimensiones personalizadas basadas en IDs de usuario genera dimensiones con demasiados valores únicos. Tener demasiados valores únicos causa problemas con los datos de Google Analytics y la precisión de los informes. Obtén más información sobre las prácticas recomendadas para configurar dimensiones personalizadas.


Antes de comenzar

Antes de enviar IDs de usuario, asegúrate de haber completado los siguientes pasos:

Envía los IDs de usuario

El valor que envías para user_id depende del estado del usuario:

  • El usuario nunca accedió: No envíes el parámetro user_id.
  • El usuario accedió: Envía su ID de usuario.
  • El usuario accedió y, luego, salió de la cuenta: Envía null.

Para enviar un ID de usuario a Analytics, agrega el parámetro user_id al comando config en cada página de tu sitio web:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. Reemplaza TAG_ID por tu ID de etiqueta.
  2. Reemplaza los comentarios por tus verificaciones para saber si el usuario accedió a su cuenta y si lo hizo, pero luego salió de ella.
  3. Si un usuario accedió a su cuenta, reemplaza USER_ID por su ID de usuario.
  4. Cuando un usuario cierra la sesión, establece user_id en null. No envíes una cadena vacía (""), una cadena en blanco (" ") ni las palabras entre comillas "null" o "NULL".