Méthodes d'identité

Voici les signatures de l’API. Pour savoir quand et comment les utiliser, lisez Identifier les utilisateurs ; pour le modèle de confiance derrière token, lisez Vérification d’identité.

identify()

identify(userId: string, traits?: Properties, options?: { token?: string }): void

kilden.identify('user_4821', { email: '[email protected]', plan: 'pro' });

Relie le visiteur anonyme courant à votre identifiant utilisateur. Émet un événement $identify portant l’identifiant anonyme ($anon_distinct_id), que le pipeline utilise pour lier ou fusionner les deux identités. À partir de cet appel, les événements portent distinct_id = userId.

• Les traits sont appliqués à la personne sous forme de $set.
• options.token définit le JWT de vérification d’identité dans le même appel — équivalent à appeler setIdentityToken(token) d’abord.
• Identifier recharge aussi les feature flags pour le nouveau distinct id.

setPersonProperties()

setPersonProperties(set: Properties, setOnce?: Properties): void

kilden.setPersonProperties(
  { plan: 'enterprise' },          // $set : écrase
  { signup_source: 'organic' },    // $set_once : seulement si pas déjà défini
);

Met à jour les traits de la personne. set écrase les valeurs existantes ; setOnce n’écrit que les clés qui n’existent pas encore. Les événements sont immuables — cet appel modifie la personne, jamais les événements passés.

reset()

kilden.reset();

À appeler à la déconnexion. Génère un nouvel identifiant anonyme, efface le token d’identité et les super properties, et recharge les feature flags. Sans cet appel, l’utilisateur suivant sur le même navigateur serait relié à l’identité de l’utilisateur précédent.

setIdentityToken()

setIdentityToken(token: string | null): void

Définit (ou efface, avec null) le JWT de vérification d’identité. Le token est envoyé avec chaque batch en Authorization: Bearer <token> et vérifié côté serveur. Préférez passer identityToken / getIdentityToken dans les options d’init pour que le rafraîchissement soit géré pour vous ; utilisez cette méthode quand votre application récupère les tokens selon son propre rythme.