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 :
- 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.
- Accédez au code source de votre site Web.
- Disposez 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. }
- Remplacez TAG_ID par votre ID de balise.
- 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é.
- Si un utilisateur est connecté, remplacez USER_ID par son ID utilisateur.
- Lorsqu'un utilisateur se déconnecte, définissez
user_idsurnull. 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.