Wendung.identify(): Associate all events with a user

Call Wendung.identify() after a user logs in or whenever their identity becomes available. Every event tracked afterwards carries the provided userId and traits. Each call replaces the previous identity wholesale; traits are not merged. Events snapshot the identity at the moment step() is called, so events already queued keep the identity they were tracked with. Throws if called before init().

Wendung.identify(userId: string, traits?: Record<string, unknown>): void

Parameters

string

required

A unique, stable identifier for the user, such as a database primary key or UUID. Sent in every subsequent event payload as identity.userId.

Record<string, unknown>

Optional key-value metadata describing the user, for example email, name, or plan. Deep-cloned at call time. Replaces any previously set traits entirely, so include every trait you want to keep. Defaults to {}.

Returns

void

Examples

Wendung.identify('usr_01HXYZ', {
  email: 'ada@example.com',
  name: 'Ada Lovelace',
  plan: 'pro',
})

Updating traits on plan change

Because identify() replaces traits rather than merging them, spread the existing traits when updating one:

Wendung.identify(currentUser.id, {
  ...currentUser.traits,
  plan: 'enterprise',
})

Traits are sent to your ingest endpoint as-is. Avoid including sensitive values such as passwords or payment card numbers.

Call reset() on logout so later events are not attributed to the previous user.

SDK Methods

Types

Wendung.identify(): Associate all events with a user

Parameters

Returns

Examples

Updating traits on plan change

​Parameters

​Returns

​Examples

​After login

​Updating traits on plan change

Parameters

Returns

Examples

After login

Updating traits on plan change