Identify Call

Using the identify call you can assign

You can use the identify API call to identify your users.

_browsee('identify', '<user_id/email>')

The second parameter to this call can be any string. However, it's best to use database IDs or a hash which does not change when a user updates their information. If the identifying parameter is common along their journey, you can unify all the sessions of a user.

You can also send attributes to the identify call like

_browsee('identify', '<user_id/email>',
         {name: 'Jon Snow',
          email: '',
          location: 'Castle Black'})

name and email are special attributes. When you send name or email in an identify call, you can see them in the session panel on the right while replaying a session

All the attributes you send via identify call can be searched for while creating circles.

You can also assign tags to a session. Like

_browsee('identify', '<user_id/email>', 
         {'$tags': ["Logged In", "Cohort 78435"]})

Like attributes, tags can be searched for while creating circles and are visible on the session replay screen. More about creating circles here.

In case you do not want to add identify information like user id/email, you can use Browsee's anonymous id and send the rest of the identify information. However, in this case you need to wait for Browsee's snippet to load and call its initialization event like this

window.addEventListener('br_session_init', ()=>{
  // Browsee's initialization event
  if (_browsee && _browsee.user && _browsee.user.getId()) {
    _browsee('identify', _browsee.user.getId(),
             {experiment_id: 'A', '$tags': ['X', 'Y']});

Important Information - Identify calls are exclusively accessible to users with paid accounts starting from the Plus plan and beyond. Check out our pricing page here.

Last updated