Identify Users

Overview

Cryptique automatically assigns anonymous IDs to track users. When you know who a user is (e.g., after login or wallet connection), use identify() to link their anonymous activity to their known identity.

Cryptique’s CQ Intelligence merge engine automatically consolidates user profiles across sessions, devices, and wallets when you call identify().

Cryptique.identify()

Associate the current user with a unique identifier.

Cryptique.identify(identifyId)

Parameters

string

required

A unique identifier for the user. This could be:

User ID from your database
Email address
Wallet address
Any unique string that identifies this user

Maximum length: 255 characters

Returns

void

Basic Usage

// After user logs in
Cryptique.identify('user_12345');

// Using email
Cryptique.identify('user@example.com');

// Using wallet address
Cryptique.identify('0x742d35Cc6634C0532925a3b844Bc9e7595f5bB21');

When to Call identify()

After Login

When a user logs into your application:

async function handleLogin(email, password) {
  const user = await login(email, password);
  
  // Identify after successful login
  Cryptique.identify(user.id);
  
  // Optionally set user properties
  Cryptique.people.set({
    email: user.email,
    plan: user.subscription,
    signupDate: user.createdAt
  });
}

After Signup

When a new user creates an account:

async function handleSignup(userData) {
  const newUser = await createUser(userData);
  
  // Identify the new user
  Cryptique.identify(newUser.id);
  
  // Track signup event
  Cryptique.track('Signup Completed', {
    source: userData.referralSource
  });
  
  // Set initial user properties
  Cryptique.people.set({
    email: newUser.email,
    signupDate: new Date().toISOString()
  });
}

On Page Load (Returning Users)

When a logged-in user returns:

// On app initialization
async function initApp() {
  await Cryptique.init({ siteId: 'your-site-id' });
  
  // If user is already logged in
  const currentUser = getCurrentUser();
  if (currentUser) {
    Cryptique.identify(currentUser.id);
  }
}

Cross-Domain Identification

Cryptique can merge user profiles across domains when you use the same identifyId:

// On app.example.com
Cryptique.identify('user_12345');

// On dashboard.example.com (same user)
Cryptique.identify('user_12345');

// Cryptique merges all sessions for user_12345 automatically

Cryptique.reset()

Clear the current user identity and start a new anonymous session. Use this when a user logs out.

Cryptique.reset()

Returns

void

Usage

function handleLogout() {
  // Clear user session in your app
  logout();
  
  // Reset Cryptique identity
  Cryptique.reset();
  
  // Future events will use a new anonymous ID
}

Always call reset() when a user logs out. Without this, the next user on the same device could be associated with the previous user’s data.

Wallet Address as Identity

You can use wallet addresses as the primary identifier:

// When wallet connects
function handleWalletConnect(address) {
  // Use wallet address as identity
  Cryptique.identify(address);
  
  // Also register with walletAddress for enrichment
  Cryptique.walletAddress(address);
}

Using wallet addresses as identifiers works well for Web3 apps where users may not have traditional accounts. The same user with multiple wallets will have separate profiles unless you link them with a common identifier.

Identity Merge Behavior

When you call identify():

New User: If the identifyId hasn’t been seen before, the current anonymous profile is converted to an identified profile.
Existing User, Same Device: If the identifyId matches a profile already on this device, sessions merge seamlessly.
Existing User, New Device: If the identifyId exists from another device, Cryptique’s CQ Intelligence merges the profiles automatically.
Group memberships: When the server returns group_memberships for this user, the SDK restores them locally so group assignments stay in sync across devices.

Best Practices

Use Persistent IDs

// Good - Stable, unique identifiers
Cryptique.identify(user.databaseId);    // '12345'
Cryptique.identify(user.uuid);          // 'a1b2c3d4-e5f6-...'
Cryptique.identify(user.walletAddress); // '0x742d...'

// Avoid - IDs that might change
Cryptique.identify(user.username);      // User might change this
Cryptique.identify(user.displayName);   // Not unique

Don’t Over-Identify

// Bad - Calling identify too frequently
function onClick() {
  Cryptique.identify(userId);  // Don't identify on every action
  Cryptique.track('Button Clicked');
}

// Good - Identify once per session
async function initApp() {
  await Cryptique.init({ siteId: 'your-site-id' });
  
  if (currentUser) {
    Cryptique.identify(currentUser.id);
  }
}

Handle Auth State Changes

// React example with auth state listener
useEffect(() => {
  const unsubscribe = auth.onAuthStateChanged((user) => {
    if (user) {
      Cryptique.identify(user.uid);
    } else {
      Cryptique.reset();
    }
  });
  
  return () => unsubscribe();
}, []);

Complete Authentication Flow

// Initialize
await Cryptique.init({ siteId: 'your-site-id' });

// Check for existing session
const user = getCurrentUser();
if (user) {
  Cryptique.identify(user.id);
  Cryptique.people.set({
    email: user.email,
    lastSeen: new Date().toISOString()
  });
}

// Login handler
async function login(credentials) {
  const user = await authService.login(credentials);
  
  Cryptique.identify(user.id);
  Cryptique.people.set({
    email: user.email,
    lastLogin: new Date().toISOString()
  });
  Cryptique.track('Login Completed');
}

// Logout handler
function logout() {
  Cryptique.track('Logout Completed');
  Cryptique.reset();
  authService.logout();
}

User Properties

Set persistent user attributes

Groups

Company and team associations

Wallet Methods

Track wallet connections

INTRO

DATA IN

DATA MODEL

BEST PRACTICES

Overview

Cryptique.identify()

Parameters

Returns

Basic Usage

When to Call identify()

Cross-Domain Identification

Cryptique.reset()

Returns

Usage

Wallet Address as Identity

Identity Merge Behavior

Best Practices

Use Persistent IDs

Don’t Over-Identify

Handle Auth State Changes

Complete Authentication Flow

User Properties

Groups

Wallet Methods

​Overview

​Cryptique.identify()

​Parameters

​Returns

​Basic Usage

​When to Call identify()

​Cross-Domain Identification

​Cryptique.reset()

​Returns

​Usage

​Wallet Address as Identity

​Identity Merge Behavior

​Best Practices

​Use Persistent IDs

​Don’t Over-Identify

​Handle Auth State Changes

​Complete Authentication Flow

​Related Methods

User Properties

Groups

Wallet Methods

Overview

Cryptique.identify()

Parameters

Returns

Basic Usage

When to Call identify()

Cross-Domain Identification

Cryptique.reset()

Returns

Usage

Wallet Address as Identity

Identity Merge Behavior

Best Practices

Use Persistent IDs

Don’t Over-Identify

Handle Auth State Changes

Complete Authentication Flow

Related Methods