The Noticeable Identify call lets you tie a user to their actions and record traits about them. It includes a unique User ID and some optional traits you know about the user, like their avatar, email, and name.

Identifying users

Noticeable recommends that you make an identify call before rendering your first widget. Using our JavaScript SDK, a typical call looks as follows:

noticeable.identify('PROJECT_ID', {
    id: 'a8ONg9xpnGmSg', // your unique user ID
    avatar: '', // optional
    name: 'John Doe',  // optional
    email: '' // optional

The first parameter to identify is your project identifier on Noticeable. To know what you project ID is, open your project in the noticeable dashboard, then look at your browser URL. Your project identifier is the sequence of characters and numbers between projects/ and /:

The second parameter is an object containing user traits. Traits are pieces of information you know about a user. For now, we allow a limited number of trait fields:

id (required): Unique ID in your database or anonymous ID for a user. This must be unique and consistent across a user's lifetime: do not use an email address or a username that can change over time.
avatar (optional): URL to an avatar image for the user.
email (optional): Email address of a user.
name (optional): User display name.

You must call noticeable.identify(...) before any call to noticeable.render('widget', ...).
Was this article helpful?
Thank you!