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 Medir la actividad en todas las plataformas. Para obtener información sobre cómo establecer un ID de usuario para una app, consulta Configurar un ID de usuario.

Si estableces dimensiones personalizadas basadas en IDs de usuario, se generarán 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 establecer dimensiones personalizadas.


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 tu ID de etiqueta.
  2. Reemplaza los comentarios por tus verificaciones para determinar 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 como 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 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 cierra la sesión

Cuando un usuario sale de su cuenta, debes borrar el user_id estableciendo su valor como 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.

Anterior
Agregar parámetros
Siguiente
Mide las excepciones