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

Le paramètre user_id est un paramètre de configuration, et non une propriété utilisateur personnalisée ni un paramètre d'événement standard. user_id est un paramètre système réservé utilisé spécifiquement pour identifier les utilisateurs authentifiés sur différents appareils et lors de différentes sessions. Ne le définissez pas comme propriété utilisateur personnalisée (par exemple, dans l'objet user_properties pour gtag.js ou dans la section Propriétés utilisateur des balises Google Tag Manager), et ne l'enregistrez pas comme dimension personnalisée dans l'interface utilisateur Analytics. De même, ne le transmettez pas en tant que paramètre au niveau de l'événement pour des événements individuels. Définissez plutôt user_id uniquement comme paramètre de configuration à l'aide des méthodes suivantes.


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 contenant un espace (" ") 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 de page initial, utilisez la gtag('set') commande. Cette commande définit le user_id pour tous les événements suivants 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.

Utilisation de l'User-ID dans Google Analytics

Une fois que vous envoyez des valeurs user_id à Google Analytics, elles sont utilisées pour :

  • Unifier les parcours utilisateur : associer l'activité des utilisateurs connectés entre différentes sessions, différents appareils et différentes plates-formes.
  • Améliorer les décomptes d'utilisateurs : fournir des métriques utilisateur plus précises et dédupliquées.
  • Activer l'analyse :
    • Analyser l'activité en fonction de l'état de connexion : utilisez des dimensions telles que "Connecté avec User-ID" pour créer des comparaisons dans les rapports standards ou des segments dans les explorations.
    • Exploiter la technique d'exploration de l'explorateur d'utilisateurs User Explorer, ce qui vous permet d'examiner en détail la chronologie des activités des utilisateurs individuels.

Remarques importantes

  • Ne créez PAS de dimensions personnalisées pour l'User-ID : vous ne devez pas enregistrer le user_id en tant que dimension personnalisée de portée utilisateur. Il s'agit d'une bonne pratique essentielle. Cela crée une dimension à cardinalité élevée inutile, ce qui peut avoir un impact considérable sur les performances des rapports, entraîner le regroupement des données dans la ligne "(other)" et consommer votre quota de dimensions personnalisées. La fonctionnalité User-ID intégrée gère l'association des utilisateurs. Pour en savoir plus, consultez Bonnes pratiques concernant l'User-ID.

  • Définissez user_id comme paramètre de configuration, et non comme propriété utilisateur ou paramètre d'événement : étant donné que user_id est un paramètre système réservé, il ne doit être appliqué que comme paramètre de configuration ou de paramètre (à l'aide des commandes gtag() config ou set, ou des paramètres de configuration de la balise Google de Google Tag Manager). Ne le configurez pas comme propriété utilisateur personnalisée, ne le transmettez pas dans l'objet de paramètres user_properties et ne l'envoyez pas en tant que paramètre au niveau de l'événement pour des événements individuels.

  • Visibilité directe de l'ID dans les rapports standards par rapport aux explorations : les valeurs user_id brutes ne sont pas disponibles en tant que dimension standard dans les rapports standards ni dans la plupart des explorations (telles que les explorations libres) afin de préserver la confidentialité et de gérer la cardinalité. Toutefois, vous pouvez afficher le user_id brut dans le modèle d'exploration de l'Explorateur d'utilisateurs sous la colonne ID utilisateur effectif pour les utilisateurs connectés.

  • Accéder aux ID utilisateur bruts : si vous devez effectuer une analyse à l'aide des valeurs brutes user_id, l'approche recommandée consiste à utiliser l' exportation BigQuery de Google Analytics 4. Le champ user_id est disponible dans les données exportées.

Pour vous assurer que les données User-ID sont utilisées et visibles dans l'explorateur d'utilisateurs, vérifiez que l'identification de reporting de votre propriété est définie sur Mixte ou Observée.

Précédent
Ajouter des paramètres
Suivant
Mesurer les exceptions