Identifying your users

Identifying your users

The Embrace.io SDK requires you to add identifiers to the current user so that you can associate them with your own internal data and perform searches and segmentation in the web dashboard. The Embrace.io SDK supports the following mechanisms for identifying your users.

Tagging users is simple and can be done using the following method calls.

Embrace.getInstance().setUsername("daniel");
Embrace.getInstance().setUserEmail("daniel@embrace.io");
Embrace.getInstance().setUserIdentifier("1337");

Untagging users is even easier and can be done by doing the following.

Embrace.getInstance().clearUsername();
Embrace.getInstance().clearUserEmail();
Embrace.getInstance().clearUserIdentifier();

Defining User Personas

User personas are a way of contextualizing certain groups of users that share a common trait or attribute. For example, if your app has a subscription model for premium content, you may want to define a subscriber persona as a way of segmenting your subscription users from your free users. Out-of-the-box, the Embrace SDK defines the payer persona for you which you can associate (or disassociate) with a particular user using the following methods.

Embrace.getInstance().setUserAsPayer();

Embrace.getInstance().clearUserAsPayer();

Of course, you’re free to define your own personas and use those instead of payer by using the following API.

Embrace.getInstance().setUserPersona("subscriber");

Embrace.getInstance().clearUserPersona("subscriber");