Envoyer des ID utilisateur

Les ID utilisateur sont des identifiants uniques que vous attribuez à chaque utilisateur. 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.

La définition de dimensions personnalisées basées sur les User-ID entraîne la création de dimensions comportant trop 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 définir des dimensions personnalisées


Avant de commencer

Avant de pouvoir envoyer des ID utilisateur, assurez-vous d'avoir effectué les actions 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 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".