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.

1. User Personas. This is data you can set and update about the user of a session.
2. Session Properties. This is data you use to track information about the device or the session itself.

User Personas

Embrace offers a set of methods to pass information about your users.

Kotlin

Embrace.getInstance().addUserPersona("internal_user_id_123")

Java

Embrace.getInstance().addUserPersona("internal_user_id_123");

Important

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

Embrace.getInstance().addUserPersona("high_value_cart")

Java

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.

info

For a full set of APIs related to user identification, see the io.embrace.android.embracesdk.Embrace class in the Android API documentation.