Métodos de identidade

Estas são as assinaturas da API. Para saber quando e como usá-las, leia Identificando usuários; para o modelo de confiança por trás de token, leia Verificação de identidade.

identify()

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

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

Vincula o visitante anônimo atual ao id do seu usuário. Emite um evento $identify carregando o id anônimo ($anon_distinct_id), que o pipeline usa para vincular ou mesclar as duas identidades. A partir dessa chamada, os eventos carregam distinct_id = userId.

• Os traits são aplicados à pessoa como um $set.
• options.token define o JWT de verificação de identidade na mesma chamada — equivalente a chamar setIdentityToken(token) antes.
• Identificar também recarrega as feature flags para o novo distinct id.

setPersonProperties()

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

kilden.setPersonProperties(
  { plan: 'enterprise' },          // $set: sobrescreve
  { signup_source: 'organic' },    // $set_once: só se ainda não estiver definido
);

Atualiza os traits da pessoa. set sobrescreve valores existentes; setOnce escreve apenas chaves que ainda não existem. Eventos são imutáveis — isto altera a pessoa, nunca eventos passados.

reset()

kilden.reset();

Chame no logout. Gera um novo id anônimo, limpa o token de identidade e as super properties, e recarrega as feature flags. Sem ele, o próximo usuário no mesmo navegador ficaria vinculado à identidade do usuário anterior.

setIdentityToken()

setIdentityToken(token: string | null): void

Define (ou limpa, com null) o JWT de verificação de identidade. O token é enviado com cada batch como Authorization: Bearer <token> e verificado no servidor. Prefira passar identityToken / getIdentityToken nas opções de init, assim o refresh fica por conta do SDK; use este método quando seu app busca tokens no próprio ritmo.