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

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 el objeto 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.

Anterior
Agregar parámetros
Siguiente
Mide las excepciones