Browser Identity API

Use the tracking script’s browser identity API when your app knows who the visitor is. Call identify() after login or signup, update profile traits with setTraits(), and clear the stored ID on logout.

window.tinyanalytics.identify('user_8f3a', {
  plan: 'pro',
  company: 'Acme'
})

Browser identity is keyless. Do not put an API key in your frontend bundle.

Available identity methods

Method	What it does
`identify(userId, traits?)`	Attach your stable ID, backfill recent anonymous activity, merge traits, and remember the ID in this browser.
`setTraits(traits)`	Merge traits for the current identified user without re-running the backfill. A `null` value deletes that key.
`getUserId()`	Return the current identified user ID, or `null`.
`clearUserId()`	Forget the identified user in this browser.

Call identify() as soon as your app knows the signed-in user’s stable internal ID:

window.tinyanalytics.identify('user_8f3a', {
  plan: 'pro',
  signupDate: '2026-01-15'
})

string

required

Your stable ID for the user, up to 255 characters. Prefer an internal database ID over a value that can change.

object

Optional profile attributes. The serialized object can be up to 2 KB.

TinyAnalytics stores the ID in the browser’s localStorage, so the user stays identified across page loads and later sessions on that device. It also attributes the visitor’s recent anonymous events to the identified user.

Update traits

Once the user is identified, call setTraits() whenever a profile value changes:

window.tinyanalytics.setTraits({
  plan: 'business',
  trialEndsAt: null
})

Traits merge with the existing profile. Keys you omit stay unchanged, and a key set to null is deleted. If no user is identified, setTraits() does nothing and writes a warning to the browser console.

Read and clear the current identity

Use getUserId() when another client-side integration needs the same ID. Clear it as part of your logout flow so another person using the browser does not inherit the previous identity.

const userId = window.tinyanalytics.getUserId()

function logOut() {
  window.tinyanalytics.clearUserId()
  endApplicationSession()
}

Anonymous measurement does not store an analytics ID in the browser. Identified mode is different: the user ID and traits you send are stored personal data. Choose a lawful basis, disclose the processing, and send only the traits you need. See Privacy & GDPR.

Verify

Identify a test user

Open the user profile

Open Users in TinyAnalytics and select the test user. Confirm the profile uses your user ID and shows the traits you sent.

Test a trait update and logout

Call setTraits() and confirm the changed value appears on the profile. Log out, then check in the browser console that window.tinyanalytics.getUserId() returns null.

The client-side identity integration is working when the profile uses your stable ID, trait changes appear, and logout clears the ID from the browser.

Identify users

Understand identity behavior, backfill, and consent.

Browser events

Send events that belong to the identified user.

Group & B2B analytics

Associate a visitor with an account from the browser.

Analytics filters

Filter reports by the traits you attach.

Start here

Browser APIs

Data API

Authentication & tools

Endpoint reference

Available identity methods

Update traits

Read and clear the current identity

Verify

Identify users

Browser events

Group & B2B analytics

Analytics filters

​Available identity methods

​Identify after login

​Update traits

​Read and clear the current identity

​Handle privacy and consent

​Verify

​Related

Identify users

Browser events

Group & B2B analytics

Analytics filters

Available identity methods

Identify after login

Update traits

Read and clear the current identity

Handle privacy and consent

Verify

Related