Identify Method

What is the Identify Method?

The Identify Method allows you to verify users by email or user ID. This method is useful when you want to pass user information to Loopbear to identify users and personalize their experience.

This is especially useful if you want to verify users without asking for their email address such as an in-app survey or feedback form.

📝

Important note. Every time a user is identified using this method, Loopbear will create a new contact if the user ID or email address does not exist in the system.

How to use the Identify Method

To identify a user, you need to pass the user's email address or user ID to Loopbear, along with a hashed version of the email address or user ID to verify the user's identity and prevent spoofing. While the hashed version is optional, it is recommended to use it for security reasons.

<script>
  window.lb("identify", {
    user_email: "michael@dundermifflin.com",
    user_hash: "ce164cf9ccb330127a786a452073d0ff178dacd111f547be5de9f155e3ad9548",
  });
</script>

How to create the hash needed for verification

To create the hash, you need to use the SHA-256 HMAC hashing algorithm on the server-side using your Loopbear Site Secret Key. This secret key is unique to your account and can be found in your Loopbear site settings under "Identity Site Key".

Here is an example of how you can create the hash using different programming languages:

const crypto = require('crypto');
 
// Example secret key and email
const secretKey = '0c8cdd05-a71e-45fd-975a-c5af116802ec';
const email = 'michael@dundermifflin.com';
 
// Create HMAC
const hmac = crypto.createHmac('sha256', secretKey)
.update(email)
.digest('hex');
 
console.log(hmac);

Variables Introduction