Formation Matomo

Paramétrer le UserID

  • Episode N° 20
  • Difficulté intermédiaire
  • Publié le 05/06/2019 par
  • 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 E-mail
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
Allez, ne t'arrête pas maintenant !
Épisode suivant
Épisode précédent
Commentaires

Vous devez être connecté pour pouvoir commenter. Se connecter

  • Publié par Sylvain

    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 nouveau userId cela me crée une nouvelle visite de type "Entrée directe" ? Comment faire pour qu'à la connexion / déconnexion le userId 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,

    1. Publié par Ronan

      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 le VisitorID 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 :

      [Tracker]
enable_userid_overwrites_visitorid = 0

      En espérant avoir répondu à ta question

Vous préférez une formation Matomo sur-mesure ?

Je réalise des formations professionnelles sur-mesure. Si ça peut vous intéresser, n'hésitez pas à me contacter 🤓

Je fais une demande