Envoyer des ID utilisateur

Les User-ID sont vos propres identifiants uniques que vous attribuez à des utilisateurs individuels. Ce guide explique comment envoyer des User-ID à Google Analytics pour associer le comportement des utilisateurs lors de différentes sessions, et sur différents appareils et 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 User-ID pour une application, consultez Définir un User-ID.

Avertissement : Ne définissez pas de dimensions personnalisées basées sur les User-ID. La définition de dimensions personnalisées basées sur les ID utilisateur entraîne la création de dimensions comportant un trop grand nombre de valeurs uniques. Un trop grand nombre de valeurs uniques pose des problèmes de précision des données et des rapports Google Analytics. En savoir plus sur les bonnes pratiques pour configurer des dimensions personnalisées

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é qui sert spécifiquement à identifier les utilisateurs authentifiés sur les appareils et les 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 comme paramètre de configuration à l'aide des méthodes suivantes.

gtag.js Tag Manager

Avant de commencer

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

• Créez un compte et une propriété Google Analytics.
• Créez un flux de données Web pour votre site Web.
• Placez la balise Google sur votre site Web.
• Avoir accès au code source de votre site Web.
• Disposer du rôle Éditeur (ou supérieur) dans le compte Google Analytics.

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 tag.
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 user_id après le chargement de page initial, utilisez la commande gtag('set'). 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 futurs événements :

// 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 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 s'il change après le chargement de la page.

Utilisation de l'User-ID dans Google Analytics

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

• Unifiez les parcours utilisateur : associez l'activité des utilisateurs connectés lors de différentes sessions, et sur différents appareils et plates-formes.
• Améliorer le nombre d'utilisateurs : fournir des métriques utilisateur plus précises et sans doublons.
• Activer l'analyse :
  • Analysez 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.
  • Elle alimente la technique d'exploration Explorateur d'utilisateurs, qui vous permet d'afficher le détail de la chronologie des activités de chaque utilisateur.

Remarques importantes

• Ne créez PAS de dimensions personnalisées pour l'User-ID : vous ne devez pas enregistrer 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, regrouper les 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 le 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 (à 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 comme paramètre au niveau de l'événement sur des événements individuels.

• Visibilité directe des ID dans les rapports standards et les 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 (comme le format libre) afin de préserver la confidentialité et de gérer la cardinalité. Toutefois, vous pouvez afficher les user_id bruts dans le modèle d'exploration Explorateur d'utilisateurs, dans la colonne ID utilisateur effectif pour les utilisateurs connectés.

• Accéder aux ID utilisateur bruts : si vous devez effectuer des analyses à l'aide des valeurs user_id brutes, nous vous recommandons d'utiliser GA4 BigQuery Export. 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'identité pour le reporting de votre propriété est définie sur Mélangée ou Observée.