Paramétrer le UserID

Épisode N° 20 de la formation Matomo, publié le 05/06/2019 par et mis à jour le 21/12/2023

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 auto-incré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 Email pourra être utilisée pour configurer le UserID dans Matomo.

Id

Nom

Prénom

Email

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, et 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 actions 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 confiuguration Matomo.

enable_userid_overwrites_visitorid=1