Envoyer des ID utilisateur

Les ID utilisateur sont vos propres identifiants uniques que vous attribuez à des utilisateurs individuels. Ce guide explique comment envoyer des ID utilisateur à Google Analytics afin de pouvoir associer le comportement des utilisateurs sur différentes sessions, différents appareils et différentes plates-formes.

Pour en savoir plus sur la fonctionnalité User-ID, consultez Mesurer l'activité sur plusieurs plates-formes. Pour savoir comment définir un ID utilisateur pour une application, consultez Définir un ID utilisateur.

Si vous définissez des dimensions personnalisées basées sur des ID utilisateur, vous obtiendrez des dimensions avec trop de valeurs uniques. Un nombre trop élevé de valeurs uniques entraîne des problèmes d'exactitude des données et des rapports Google Analytics. Découvrez les bonnes pratiques pour définir des dimensions personnalisées.


Avant de commencer

Avant de pouvoir envoyer des ID utilisateur, assurez-vous d'avoir effectué les opérations suivantes :

Envoyer des ID utilisateur

La valeur que vous envoyez pour user_id dépend de l'état de l'utilisateur :

  • L'utilisateur ne s'est jamais connecté : n'envoyez pas le paramètre user_id.
  • L'utilisateur est connecté : envoyez son ID utilisateur.
  • L'utilisateur était connecté, puis s'est déconnecté : envoyez null.

Pour envoyer un ID utilisateur à Analytics, ajoutez le paramètre user_id à la commande config sur chaque page de votre site 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. Remplacez TAG_ID par votre ID de balise.
  2. Remplacez les commentaires par vos vérifications pour savoir si l'utilisateur est connecté, et s'il était connecté, mais s'est ensuite déconnecté.
  3. Si un utilisateur est connecté, remplacez USER_ID par son ID utilisateur.
  4. Lorsqu'un utilisateur se déconnecte, définissez user_id sur null. N'envoyez pas de chaîne vide (""), de chaîne vide (" ") ni les mots entre guillemets "null" ou "NULL".

Définir l'ID utilisateur après l'initialisation

Dans de nombreux cas, le user_id n'est pas connu lors de la première initialisation de la balise Google. Par exemple, un utilisateur peut visiter votre site et ne se connecter que plus tard.

Pour définir ou mettre à jour le user_id après le chargement initial de la page, utilisez la gtag('set') commande. Cette commande définit le user_id pour tous les événements ultérieurs sur la page. Il s'agit de l'approche recommandée au lieu de gtag('config') dans ce scénario.

Définir l'ID utilisateur lors de la connexion

Lorsqu'un utilisateur se connecte, appelez gtag('set') pour associer son ID aux événements futurs :

// 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');

Effacer l'ID utilisateur lors de la déconnexion

Lorsqu'un utilisateur se déconnecte, vous devez effacer le user_id en définissant sa valeur sur 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();

En utilisant gtag('set'), vous vous assurez que le user_id est correctement géré tout au long de la session utilisateur, reflétant l'état de connexion actuel de l'utilisateur, même si il change après le chargement de la page.