Aller au contenu principal

Profils Utilisateurs

Open in QuickMonitoring→ Sites → [Votre Site] → Feature Flags → Personnes

QuickMonitoring construit un profil pour chaque utilisateur qui appelle QMTracker.identify(). Les profils accumulent l'historique des événements, les évaluations de flags et les propriétés personnalisées — permettant un ciblage précis.

Ce que vous verrez​

La page Personnes (accessible depuis la section Feature Flags) affiche la liste de tous les utilisateurs identifiés pour ce site :

  • Identifiant utilisateur (userId) — l'ID passé dans identify()
  • Dernière activité — date et heure du dernier événement reçu
  • Propriétés — aperçu des traits principaux (plan, pays, email, etc.)
  • Nombre d'événements — total des événements suivis pour cet utilisateur
  • Flags actifs — liste des feature flags pour lesquels cet utilisateur est exposé

En cliquant sur un utilisateur, vous accédez à sa fiche de profil détaillée.

Détail d'un profil​

La fiche d'un utilisateur contient plusieurs sections :

Identité

  • userId — identifiant stable de l'utilisateur
  • anonymousId — identifiant généré avant l'appel à identify(), utilisé pour les visiteurs anonymes
  • Première visite et dernière activité

Propriétés Toutes les propriétés envoyées via QMTracker.identify(), avec leur valeur actuelle. Les propriétés sont mis à jour à chaque nouvel appel identify() pour cet utilisateur.

Feature Flags Listes des flags évalués pour cet utilisateur et la valeur retournée (true/false ou clé de variante).

Historique des événements Chronologie de tous les événements suivis (track, page, identify) avec horodatage.

Comment l'utiliser​

Étape 1 — Envoyer un appel identify()​

Les profils sont créés automatiquement à chaque appel à QMTracker.identify(). Appelez cette méthode dès que l'identité de l'utilisateur est connue (après connexion, par exemple) :

QMTracker.identify('user-789', {
  email: 'marie@example.com',
  prenom: 'Marie',
  plan: 'pro',
  country: 'CA',
  beta_tester: true,
  inscription_date: '2025-01-15'
});

Règles importantes :

  • Le premier argument est l'userId — utilisez un identifiant stable et unique (ID de base de données, UUID), pas un email qui peut changer.
  • Le deuxième argument est un objet de propriétés libre — toutes les clés sont indexées et disponibles pour le ciblage.
  • Appelez identify() à chaque connexion, même si les propriétés n'ont pas changé, pour maintenir la date de dernière activité à jour.

Étape 2 — Enrichir le profil au fil du temps​

Vous pouvez appeler identify() plusieurs fois avec des propriétés différentes. Les nouvelles propriétés sont fusionnées (merge) avec le profil existant — les propriétés existantes sont mises à jour, les nouvelles sont ajoutées :

// Au moment de la connexion
QMTracker.identify('user-789', { plan: 'free' });

// Après un upgrade
QMTracker.identify('user-789', { plan: 'pro', upgraded_at: '2025-03-01' });
// Le profil contient maintenant plan: 'pro' et upgraded_at: '2025-03-01'

Étape 3 — Rechercher un utilisateur​

Dans la page Personnes, utilisez la barre de recherche pour trouver un utilisateur par :

  • Son userId
  • Son email (si passé dans les propriétés)
  • Toute propriété personnalisée

Étape 4 — Vérifier les évaluations de flags​

Sur la fiche d'un utilisateur, consultez la section Feature Flags pour voir quels flags sont actifs pour cet utilisateur et pourquoi (règle de ciblage, déploiement progressif, opt-in manuel). Cet outil est précieux pour déboguer des problèmes de ciblage.

Fusion des identités anonyme/connectée​

Avant qu'un utilisateur se connecte, il est tracké avec un anonymousId généré automatiquement par le SDK. Lorsque identify() est appelé pour la première fois, QuickMonitoring fusionne l'historique anonyme avec le nouveau profil identifié. Ainsi, les événements pré-connexion (visites de pages, clics, etc.) sont associés au bon utilisateur.

Condition de validation​

Vous obtenez cet achievement lorsque : au moins un profil utilisateur est visible dans la page Personnes, créé par un appel à QMTracker.identify() avec un userId et au moins une propriété.

Problèmes courants​

La page Personnes est vide. Vérifiez que QMTracker.identify() est appelé dans votre code et que le SDK est correctement initialisé. Consultez la console du navigateur pour vous assurer qu'il n'y a pas d'erreurs réseau lors de l'envoi des données.

Le même utilisateur apparaît en double. Cela se produit quand des userId différents sont utilisés pour le même utilisateur réel (ex. 123 vs user-123). Assurez-vous de toujours utiliser le même format d'identifiant dans tous vos appels identify().

Les propriétés ne sont pas mises à jour. identify() effectue une fusion (merge) des propriétés — il ne remplace pas le profil entier. Si vous souhaitez supprimer une propriété, passez null comme valeur : { ancienne_propriete: null }.

Les flags actifs ne s'affichent pas sur la fiche d'un utilisateur. Les évaluations de flags ne sont enregistrées dans le profil que si QMTracker.getFlag() est appelé alors que l'utilisateur est identifié. Si getFlag() est appelé avant identify(), l'évaluation est attribuée à l'utilisateur anonyme.