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.

Although this method offers convenience in certain scenarios, it falls short in preventing impersonation. We recommend to configure end-user authentication instead.

Configuring user identification

The identify call must be made before rendering your first widget. Using our JavaScript SDK, this typically looks as follows:

noticeable.identify('PROJECT_ID', {
    id: 'a8ONg9xpnGmSg', // your unique user ID (required)
    avatarUrl: 'https://acme.com/john.png', // optional
    displayName: 'John Doe',  // optional
    firstName: 'John',  // optional
    email: 'john.doe@acme.com' // optional
    lastName: 'Doe',  // optional
});
noticeable.render(...);

The first parameter to identify is your project identifier on Noticeable. 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.
avatarUrl (optional): URL to an avatar image for the user.
displayName (optional): User display name.
firstName (optional): User display name.
email (optional): Email address of a user.
lastName (optional): Email address of a user.

You must call noticeable.identify(...) before any call to noticeable.render('widget', ...).

Why is it useful to identity users?

Identifying users through the Noticeable Identify call allows you to connect a user's actions, such as leaving feedback or comments, with a user account on your side, providing valuable context for issue resolution. For instance, if a user reports a bug, you can identify the plan they are on by linking their comment to their customer account.

Moreover, user identification is also essential for enabling cross-device synchronization, where users can have a seamless experience across multiple devices.

Updated on: 09/17/2023