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 de los usuarios 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 configurar 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 todos los dispositivos y sesiones. No lo establezcas 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 lo siguiente:

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ó: 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 el ID de tu etiqueta.
  2. Reemplaza los comentarios por tus verificaciones para saber si el usuario accedió y si accedió y, luego, salió.
  3. Si un usuario accedió, reemplaza USER_ID por su ID de usuario.
  4. Cuando un usuario salga, establece user_id en null. No envíes una cadena vacía (""), una cadena en blanco (" ") ni las palabras entre comillas "null" o "NULL".

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

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

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

Establece el ID de usuario cuando se acceda

Cuando un usuario acceda 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 salga

Cuando un usuario salga, debes borrar el user_id estableciendo 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 el user_id se administre correctamente durante la sesión del usuario, lo que refleja el estado de acceso actual del usuario, incluso si cambia después de que se carga la página.

Cómo se usa User-ID en Google Analytics

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

  • Unificar los recorridos del usuario: Conectar la actividad del usuario en diferentes sesiones, dispositivos y plataformas para los usuarios que accedieron
  • Mejorar los recuentos de usuarios: Proporcionar métricas de usuarios más precisas y sin duplicados
  • Habilitar el análisis:
    • Analizar la actividad en función del estado de acceso: Usar dimensiones como "Sesión iniciada con ID de usuario" para crear comparaciones en informes estándares o segmentos en Exploraciones
    • Potenciar la técnica de exploración del Explorador de usuarios, lo que te permite desglosar la cronología de actividades de usuarios individuales

Consideraciones importantes

  • NO crees dimensiones personalizadas para el ID de 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 crea 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 unió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 de evento:Debido a 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 en comparación con las exploraciones: Los valores user_id sin procesar no están disponibles como una dimensión estándar en los informes estándares ni en la mayoría de las exploraciones (como la exploración de forma libre) para mantener la privacidad y administrar la cardinalidad. Sin embargo, puedes ver el user_id sin procesar en la plantilla de exploración del Explorador de usuarios en la columna etiquetada como ID de usuario efectivo para los usuarios que accedieron.

  • Acceso a IDs de usuario sin procesar: Si necesitas realizar análisis con los valores user_id sin procesar, el enfoque recomendado es usar la GA4 BigQuery Export. 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é establecida en Combinada o Observada.

Anterior
Agregar parámetros
Siguiente
Mide las excepciones