Know Your Users
Embrace offers two ways you can annotate sessions with information that will help developers and customer service agents find sessions for an unhappy user.
- User Personas and Identifiers. This is data you can set and update about the user of a session.
- Session Properties. This is data you use to track information about the device or the session itself.
User Personas and identifiers
Embrace offers a set of methods to pass information about your users. You can set a "persona" for the session's user, such as tester or VIP. You can also add a user identifier, which will be an Embrace-specific ID for identifying the session in the dashboard.
- Kotlin
- Java
Embrace.getInstance().addUserPersona("internal_user")
Embrace.getInstance().setUserIdentifier("internal_user_id_123")
Embrace.getInstance().addUserPersona("internal_user");
Embrace.getInstance().setUserIdentifier("internal_user_id_123")
Remember that this data will be uploaded to Embrace, so think about the privacy of your users and only include data you are willing to share. We recommend using an anonymized or hashed user ID that only your agents can search for.
The above call annotates the session with a user identifier that you can use later to search for this user. For more methods on setting user values, see the API docs.
You can also set customized values for specific use cases or segments of users.
- Kotlin
- Java
Embrace.getInstance().addUserPersona("high_value_cart")
Embrace.getInstance().addUserPersona("high_value_cart");
In the above example, the session is annotated with "high_value_cart".
This will help you identify users who have a certain dollar value in their shopping cart so you can prioritize fixing bugs that affect such users.
For a full set of APIs related to user identification, see the io.embrace.android.embracesdk.Embrace class in the Android API documentation.