Métodos de identidad

Estas son las firmas de la API. Para saber cuándo y cómo usarlas, lee Identificar usuarios; para el modelo de confianza detrás de token, lee Verificación de identidad.

identify()

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

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

Vincula al visitante anónimo actual con tu user id. Emite un evento $identify que lleva el id anónimo ($anon_distinct_id), que el pipeline usa para enlazar o mergear las dos identidades. A partir de esta llamada, los eventos llevan distinct_id = userId.

• Los traits se aplican a la persona como un $set.
• options.token setea el JWT de verificación de identidad en la misma llamada — equivalente a llamar antes a setIdentityToken(token).
• Identificar también recarga los feature flags para el nuevo distinct id.

setPersonProperties()

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

kilden.setPersonProperties(
  { plan: 'enterprise' },          // $set: sobrescribe
  { signup_source: 'organic' },    // $set_once: solo si no estaba seteado
);

Actualiza los traits de la persona. set sobrescribe valores existentes; setOnce escribe solo las keys que todavía no existen. Los eventos son inmutables — esto cambia a la persona, nunca a los eventos pasados.

reset()

kilden.reset();

Llámalo en el logout. Genera un id anónimo nuevo, limpia el identity token y las super properties, y recarga los feature flags. Sin esto, el siguiente usuario en el mismo navegador quedaría vinculado a la identidad del usuario anterior.

setIdentityToken()

setIdentityToken(token: string | null): void

Setea (o limpia, con null) el JWT de verificación de identidad. El token se envía con cada batch como Authorization: Bearer <token> y se verifica en el servidor. Prefiere pasar identityToken / getIdentityToken en las opciones de init para que el refresco se maneje por ti; usa este método cuando tu app obtiene tokens con su propio calendario.