🆔 User Identification

📘
User Identification is available on our Company Plan and above. Compare Plans | Upgrade Now

When looking at feedback, it's important to know who it's coming from. Userback User identification provides a seamless experience for your users so you can get the best feedback possible.

All you need to do is send us your user details via our JavaScript API or HTML Widget.

Once Users are identified, you can group your users together based on who they are and how they use your product.

Each time feedback is submitted by a user, the user data is added or updated in Userback.

Userback can store 3 types of data about your users.

Name	Description	Example
uid	A string containing your unique identifier for a user.	`123456`
default attributes `name` `email` `location` `first seen` `last seen`	The attributes every identified user has in Userback. > Note: name and email attributes can be set via API. The other attributes are automatically generated by the system.	`{ name: 'Nathan Peck', email: '[email protected]' }`
custom attributes	A JSON object with key/value pairs that provides additional information about your user (optional).	`{ plan: 'Pro', account_id: 456785 }`

Identify Option 1: HTML Embed code

user_data

Note: Use user_data when the JavaScript SDK hasn't been added. Otherwise, use the identify() method (see below).

window.Userback = window.Userback || {};
Userback.access_token = 'Userback Widget Token';

Userback.user_data = {
    id: 123456,
    info: {
        name: 'Nathan Peck',
        email: '[email protected]',
        plan: 'Pro',
        account_id: 456785
    }
};

(function(d) {
    var s = d.createElement('script');s.async = true;
    s.src = 'https://static.userback.io/widget/v1.js';
    (d.head || d.body).appendChild(s);
})(document);

Identify Option 2: Javascript API

identify(uid, attributes)

uid: string
attributes: object (optional)

/ Load widget code in your app  
window.Userback = window.Userback || {};  
Userback.access_token = '[YOUR_ACCESS_TOKEN]';

(function(d) {  
    var s = d.createElement('script');s.async = true;  
    s.src = 'https://static.userback.io/widget/v1.js';  
    (d.head || d.body).appendChild(s);  
})(document);

// Call identify when a user is logged in  
MyApp.on('login', () => {  
    Userback.identify(123456, {  
        name: 'Nathan Peck',  
        email: '[email protected]',  
        plan: 'Pro',  
        account_id: 456785  
    });  
});

Note:

The identify() method can be called multiple times. The previous data gets overwritten when identify() is called again.
Key names can’t contain periods ('.'), dollar signs ('$'), characters like ~`[email protected]#%^&*'{}|'". — If an unsupported character is used, the key will be created with an underscore in its place.
Data values must be sent as JSON strings, numbers or booleans (true or false). We can’t accept object, nested hashes and array data formats.

View User Data
The user data collected with your feedback will display on the right hand panel.