Identité

Un visiteur reste anonyme tant que ton application ne l’identifie pas : aucune person n’est créée pour lui. Une fois identifié, toutes les sessions de son navigateur sont rattachées à sa person, visible dans l’onglet Persons du dashboard.

Identifier après la connexion : identify()

// Après le login, avec l'identifiant de l'utilisateur dans ton système.
belvdr.identify('user_42')

• L’identifiant (userId) est celui de ton système : 1 à 200 caractères, pris tel quel. Il devient l’externalId de la person, le même que dans l’API serveur.
• La person est créée si elle n’existe pas, et le navigateur lui est rattaché : toutes les sessions de ce navigateur, y compris les sessions anonymes d’avant la connexion, apparaissent sur sa fiche.
• Si l’utilisateur est déjà connecté au chargement de la page, identifie-le dès le démarrage : belvdr.startSession({ userId: 'user_42' }).
• Réidentifier le même utilisateur ne renvoie rien. Avant startSession(), rien n’est stocké : l’identification s’applique au démarrage.

Déconnexion : reset()

// Au logout.
belvdr.reset()

reset() donne au navigateur un nouvel identifiant anonyme et démarre une nouvelle session ; les autres onglets suivent. La suite de la visite n’est plus rattachée à la person.

Changement d’utilisateur

Identifier un autre utilisateur sur un navigateur déjà identifié (identify('user_B') après user_A, sans reset()) démarre une nouvelle session avec un nouvel identifiant de navigateur. Les deux persons ne sont jamais fusionnées.

Comment ça marche

• Chaque navigateur a un identifiant, le distinctId, créé au premier startSession(), partagé entre ses onglets et conservé par stopSession().
• identify() ajoute un event $identify à l’envoi suivant : l’API crée la person si besoin et lui rattache le distinctId.
• Un $identify vers un distinctId déjà rattaché à une autre person est ignoré.
• Les propriétés d’une person (nom, email, offre…) se posent depuis ton backend, avec l’API serveur.