User Identification

Link analytics data to your application’s user accounts.

Identify users

Call revlytics.identify() after a user signs in:

revlytics.identify("user_123", {
  name: "Jane Doe",
  email: "[e-mail]",
  plan: "pro",
});

Parameters

Parameter	Type	Description
userId	string	Your application’s unique user identifier
traits	object	Optional user properties (name, email, plan, etc.)

Update traits

Update user traits without re-identifying:

revlytics.setTraits({ plan: "enterprise", company: "Acme" });

Get current user

const userId = revlytics.getUserId();

Clear user

Call on sign-out to stop associating events with the user:

revlytics.clearUserId();

Persistence

The user ID is stored in localStorage under the key _rvl_uid. It persists across page reloads and browser sessions until explicitly cleared.

Example: Next.js auth flow

"use client";
import { useEffect } from "react";

export function AuthProvider({ user, children }) {
  useEffect(() => {
    if (user) {
      window.revlytics?.identify(user.id, {
        email: user.email,
        name: user.name,
      });
    } else {
      window.revlytics?.clearUserId();
    }
  }, [user]);

  return <>{children}</>;
}