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.

El parámetro user_id es un parámetro de configuración, no una propiedad del usuario personalizada ni un parámetro de evento estándar. En cambio, user_id es un parámetro del sistema reservado que se usa específicamente para identificar a los usuarios autenticados en dispositivos y sesiones. No lo configures como una propiedad del usuario personalizada (por ejemplo, en el objeto user_properties para gtag.js o en la sección Propiedades del usuario de las etiquetas de Google Tag Manager) ni lo registres como una dimensión personalizada en la IU de Analytics. Del mismo modo, no lo pases como un parámetro a nivel del evento en eventos individuales. En su lugar, establece user_id solo como un parámetro de configuración con los siguientes métodos.


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".

Configura el ID de usuario después de la inicialización

En muchos casos, el user_id no se conoce cuando se inicializa la etiqueta de Google por primera vez. Por ejemplo, un usuario puede visitar tu sitio y acceder solo más tarde.

Para establecer o actualizar user_id después de la carga inicial de la página, usa el comando gtag('set'). Este comando establece user_id para todos los eventos posteriores en la página y es el enfoque recomendado en lugar de gtag('config') en este caso.

Configura el ID de usuario cuando se accede

Cuando un usuario accede correctamente, llama a gtag('set') para asociar su ID con eventos futuros:

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

Borra el ID de usuario cuando se cierre la sesión

Cuando un usuario cierra la sesión, debes borrar el objeto user_id configurando su valor en null:

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

Si usas gtag('set'), te aseguras de que user_id se administre correctamente durante toda la sesión del usuario, lo que refleja el estado de acceso actual del usuario, incluso si cambia después de que se cargue la página.

Cómo se usa el User-ID en Google Analytics

Una vez que envías valores de user_id a Google Analytics, estos se utilizan para lo siguiente:

  • Unifica los recorridos de los usuarios: Conecta la actividad del usuario en diferentes sesiones, dispositivos y plataformas para los usuarios que accedieron a su cuenta.
  • Mejora los recuentos de usuarios: Proporciona métricas de usuarios más precisas y sin duplicados.
  • Habilita el análisis:
    • Analiza la actividad según el estado de acceso: Usa dimensiones como "Acceso con ID del usuario" para crear comparaciones en los informes estándares o segmentos en Exploraciones.
    • Potencia la técnica de exploración del Explorador de usuarios, lo que te permite desglosar el cronograma de actividades de usuarios individuales.

Consideraciones importantes

  • NO crees dimensiones personalizadas para el ID del usuario: No debes registrar el user_id como una dimensión personalizada centrada en el usuario. Esta es una práctica recomendada clave. Si lo haces, se creará una dimensión de alta cardinalidad innecesaria, lo que puede afectar gravemente el rendimiento de los informes, hacer que los datos se agrupen en la fila "(other)" y consumir tu cuota de dimensiones personalizadas. La función User-ID integrada controla la vinculación de usuarios. Obtén más información en Prácticas recomendadas para User-ID.

  • Establece user_id como un parámetro de configuración, no como una propiedad del usuario ni un parámetro del evento: Dado que user_id es un parámetro del sistema reservado, solo se debe aplicar como un parámetro de configuración (con los comandos gtag() config o set, o los parámetros de configuración de la etiqueta de Google de Google Tag Manager). No lo configures como una propiedad del usuario personalizada, no lo pases dentro del objeto de configuración user_properties ni lo envíes como un parámetro a nivel del evento en eventos individuales.

  • Visibilidad directa del ID en informes estándares y exploraciones: Los valores sin procesar de user_id no están disponibles como dimensión estándar en los informes estándares ni en la mayoría de las exploraciones (como Formato libre) para mantener la privacidad y administrar la cardinalidad. Sin embargo, puedes ver el user_id sin procesar en la plantilla de exploración Explorador de usuarios en la columna etiquetada como ID de usuario efectivo para los usuarios que accedieron.

  • Acceso a los IDs de usuario sin procesar: Si necesitas realizar análisis con los valores de user_id sin procesar, el enfoque recomendado es usar la exportación de BigQuery de Google Analytics 4. El campo user_id está disponible en los datos exportados.

Para asegurarte de que los datos de User-ID se usen y sean visibles en el Explorador de usuarios, asegúrate de que la identidad de informes de tu propiedad esté configurada como Combinada o Observada.

Anterior
Agregar parámetros
Siguiente
Mide las excepciones