Unified ID Linkage Scenario
This document explains a hypothetical scenario as an example to help you understand the configuration of user information and terminal connection due to user identification information settings.
First time installing the app
To initialize the SDK, users must follow the steps outlined in the integration guide for each platform.
User Login
This section shows the process of transitioning from an anonymous user profile state to an identified user profile.
1. Set user identification information
Before recording a login event, EXTERNAL_IDset the user identification information to a value that distinguishes the user. Through this process, the user is converted from an anonymous user profile to an identified user profile, and a unified ID is generated so that the user can be identified through the unified ID on any platform.
DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "A")
//You can increase the accuracy of user identification by setting additional identification information.
DfineryProperties.setIdentity(DFIdentity.EMAIL, "[email protected]")
DfineryProperties.setIdentity(DFIdentity.PHONE_NO, "8201012345678")
...Unexpected error with integration mermaid: Integration is not installed on this space
2. Setting up a user profile
If there is information required for the settings corresponding to the identified user A, it is reflected through the user profile settings.
User profiles can reflect arbitrary key values āāset by the user in the console.
DfineryProperties.setUserProfile(DFUserProfile.GENDER, DFGender.MALE)
DfineryProperties.setUserProfile(DFUserProfile.MEMBERSHIP, "VIP")
...Unexpected error with integration mermaid: Integration is not installed on this space
3. Record login events
Logs login events.
Dfinery.getInstance().logEvent(DFEvent.LOGIN)User logout
This section shows the process of an identified user A logging out.
1. Record the logout event
Logs logout events.
Dfinery.getInstance().logEvent(DFEvent.LOGOUT)2. Initialize user identification information (optional)
If you do not want actions to be targeted to identified user A after he or she logs out, resetIdentity()initialize the user identification information by calling the API.
Please be careful when making calls, as initializing user identification information will interrupt any ongoing event flow and disconnect the terminal from the user.
If you still call, please call the event you want to reflect before calling the API to reflect the collected events.
DfineryProperties.resetIdentity();EXTERNAL_IDLogin using existing
EXTERNAL_IDLogin using existingThis section EXTERNAL_IDshows how a user who has previously set up unified identity information can log in again using the same values.
1. Set user identification information
If the entered EXTERNAL_IDvalue is the same as the existing one, the terminal will be reconnected with the previously created identified user A.
DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "A")2. Record login events
The flow of events continues as before, with the event flow of identified user A continuing.
Dfinery.getInstance().logEvent(DFEvent.LOGIN)Unexpected error with integration mermaid: Integration is not installed on this space
EXTERNAL_IDLog in using another
EXTERNAL_IDLog in using anotherThis section EXTERNAL_IDshows how a user who has set up unified identity information can log in using different values.
1. Set user identification information
If the entered EXTERNAL_IDvalue is different from the existing one, the SDK determines that the user is a different user and deletes all previously saved integrated ID information and sets a new one, and the terminal is connected to the identified user B.
DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "B")Unexpected error with integration mermaid: Integration is not installed on this space
2. Setting up a user profile
The user profile is reflected to the identified user B.
DfineryProperties.setUserProfile(DFUserProfile.GENDER, DFGender.FEMALE)
DfineryProperties.setUserProfile(DFUserProfile.MEMBERSHIP, "VVIP")
...Unexpected error with integration mermaid: Integration is not installed on this space
3. Record login events
The flow of events changes to the flow of events for the newly identified user B.
Dfinery.getInstance().logEvent(DFEvent.LOGIN)Unexpected error with integration mermaid: Integration is not installed on this space
Terminology
Anonymous user profile
If you do not set up user identification information, the user will be treated as an anonymous user. For example, this could be a user who visited your website but did not register, or a user who downloaded your mobile app but did not create a profile.
When a user is initially recognized through the SDK, a unique identifier generated by the SDK is issued and an anonymous user profile is created.
Identified user profiles
If you set a value for one of the identification information types below, EXTERNAL_IDyou will be treated as an identified user in DFINERY, and you will be able to identify the same user profile on multiple devices. You can also set additional information such as user email and phone number for more specific user identification.
Last updated