​

Identity methods

​

identify(userId, traits?)

Selektable.identify('user-123', {
  name: 'John Doe',
  email: 'john@example.com',
  plan: 'premium'
});

• Persists userId and traits in the browser
• Updates the in-memory identity state
• Sends identity update to all currently open widgets
• Sends the identity data to the Selektable server in the background

​

reset()

Selektable.reset();

• Generates a new visitor ID, session ID, and anonymous ID
• Removes stored user ID and traits
• Updates all open widgets with the new identity

​

getIdentity()

const identity = Selektable.getIdentity();

{
  visitorId: string;      // Persistent browser ID
  sessionId: string;      // Current session ID
  anonymousId: string;    // Anonymous ID (initially same as visitorId)
  userId?: string;        // Set after identify() is called
  traits?: Record<string, unknown>;  // Set after identify() is called
}

​

setVisitorId(visitorId)

Selektable.setVisitorId('my-tracking-id-abc');

• Overwrites the visitor ID
• If no user is identified, also updates the anonymous ID
• Updates the in-memory identity state