Paramétrer le UserID
- Episode N° 20
- Difficulté intermédiaire
- Publié le 05/06/2019 par Ronan HELLO
- Dernière mise à jour le 29/09/2024
Matomo est doté d’une fonctionnalité intéressante appelée UserID
(ID Utilisateur en français). Cette fonctionnalité permet à Matomo de suivre des sessions utilisateurs dans le temps et sur différents appareils. Le UserID
ne fonctionne que si vos visiteurs sont connectés à un espace membre de votre site web.
Pour activer cette fonctionnalité, il vous suffit de copier cette ligne juste avant "TrackPageView" dans votre code de suivi Matomo.
// Active le suivi par UserID
_paq.push(['setUserId', 'IDENTIFIANT UNIQUE A METTRE ICI']);
Cette ligne de code vous permet de faire remonter un identifiant unique (lié à la personne) pour la session en cours.
Bien choisir son identifiant
Une fois cette ligne ajoutée à votre code de suivi Matomo, il faut y assigner un identifiant unique pour chacun de vos utilisateurs. Généralement, votre base de données le fait naturellement avec un identifiant autoincrémenté, dans tous les cas, assurez-vous que cette donnée soit unique et bien rattachée au compte utilisateur de chacun de vos visiteurs. Par exemple, dans le tableau ci-dessous, la colonne ID ou E-mail pourra être utilisée pour configurer le UserID
dans Matomo.
Id | Nom | Prénom | |
---|---|---|---|
33 | Curie | Pierre | pierre.curie@mail.com |
34 | Curie | Marie | marie.curie@mail.com |
35 | Flamel | Nicolas | nicolas.flamel@mail.com |
Paramétrer UserID
pour Wordpress
Pour une utilisation dans le cadre d’un site réalisé avec le CMS WordPress, vous pouvez assez aisément récupérer l’identifiant unique de l’utilisateur à l’aide de cette fonction :
// Permet de récupérer l'identifiant de la personne connectée
get_current_user_id();
Voir la documentation WordPress de la fonction.
Attention, sur votre site internet, les utilisateurs ne sont pas toujours connectés et peuvent donc être anonyme, pour cela, mettez la fonction précédente dans une condition qui permettra de savoir si l’utilisateur est actuellement connecté ou non.
// Retourne true si l'utilisateur est connecté
is_user_logged_in()
Voir la documentation WordPress de la fonction
Voici un exemple de code de suivi prenant en charge le UserID
avec WordPress :
<!-- Matomo -->
<script type="text/javascript">
var _paq = window._paq || [];
/* tracker methods like "setCustomDimension" should be called before "trackPageView" */
/* Mise en place du UserID /
<?php if(is_user_logged_in()): ?>
_paq.push(['setUserId', '<?php echo get_current_user_id(); ?>']);
<?php endif; ?>
/ Fin de mise en place du UserID */
_paq.push(['trackPageView']);
_paq.push(['enableLinkTracking']);
(function() {
var u="//matomo.mon-super-site.fr/";
_paq.push(['setTrackerUrl', u+'matomo.php']);
_paq.push(['setSiteId', '1']);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
})();
</script>
<!-- End Matomo Code -->
Retrouvez les utilisateurs sur Matomo
Une fois ces éléments mis en place, vous retrouverez les utilisateurs sous forme d’un tableau dans la partie « Visiteurs » puis ‘Utilisateurs’ de votre interface Matomo. Si vous avez réussi, vous devriez voir apparaitre votre premier utilisateur (probablement vous-même) dans le tableau.
Tentez à présent de vous connecter sur votre site à l’aide d’un smartphone ou d’un autre PC avec un autre navigateur web, vous verrez que les sessions seront bien comptabilisées pour un seul et unique visiteur, et non deux visiteurs différents. Le UserID
permet donc de gagner en précision et en pertinence des données collectées.
Configuration spéciale
Dans certains cas de figure, vous souhaitez que l'identifiant de l'utilisateur soit utilisé pour marque chaque action de l'utilisateur même après que cet utilisateur se soit déconnecté. Pour cela, il faudra acter le fait que le UserId
écrase la valeur du VisitrorId
en ajoutant cette ligne dans votre fichier de configuration Matomo.
enable_userid_overwrites_visitorid=1
Je réalise des formations professionnelles sur-mesure. Si ça peut vous intéresser, n'hésitez pas à me contacter 🤓
Je fais une demande-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
Vous devez être connecté pour pouvoir commenter. Se connecter
Bonjour Ronan et merci pour cette documentation très complète !
J'avais cependant une petite question concernant le
userId
: est-ce normal que lorsque je me connecte et que j'envoie un nouveauuserId
cela me crée une nouvelle visite de type "Entrée directe" ? Comment faire pour qu'à la connexion / déconnexion leuserId
se mettent à jour sans créer de nouvelles visites ?Si ce n'était pas possible, le mieux serait de passer par une Dimension Personnalisé de visite non ?
Merci d'avance pour votre aide,
Bonjour Sylvain,
Merci pour ton retour !
C’est un comportement normal pour Matomo, lorsque tu définis un
UserID
, cet identifiant prend le relai et Matomo n’utilise plus leVisitorID
classique.Pour éviter ce comportement et faire en sorte que Matomo ne créé pas de nouvelle visite, il faut ajouter ce réglage dans le fichier
config.ini.php
de ton instance Matomo OnPremise :En espérant avoir répondu à ta question