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.

Java

DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "A")
//You can increase the accuracy of user identification by setting additional identification information.
DfineryProperties.setIdentity(DFIdentity.EMAIL, "[e-mail]")
DfineryProperties.setIdentity(DFIdentity.PHONE_NO, "8201012345678")
...

Swift

Dfinery.shared().setIdentity(key: DFIdentity.EXTERNAL_ID, value: "A")
//You can increase the accuracy of user identification by setting additional identification information.
Dfinery.shared().setIdentity(key: DFIdentity.EMAIL, value: "[e-mail]")
Dfinery.shared().setIdentity(key: DFIdentity.PHONE_NO, value: "821012345678")
...

Javascript

Dfinery.setIdentity(DFIdentity.EXTERNAL_ID, "A")
//You can increase the accuracy of user identification by setting additional identification information.
Dfinery.setIdentity(DFIdentity.EMAIL, "[e-mail]")
Dfinery.setIdentity(DFIdentity.PHONE_NO, "8201012345678")

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.

Java

DfineryProperties.setUserProfile(DFUserProfile.GENDER, DFGender.MALE)
DfineryProperties.setUserProfile(DFUserProfile.MEMBERSHIP, "VIP")
...

Swift

Dfinery.shared().setUserProfile(key: DFUserProfile.GENDER, value: DFGENDER.MALE)
Dfinery.shared().setUserProfile(key: DFUserProfile.MEMBERSHIP, value: "VIP")
...

Javascript

Dfinery.setUserProfile(DFUserProfile.GENDER, DFGender.MALE)
Dfinery.setUserProfile(DFUserProfile.MEMBERSHIP, "VIP")
...

3. Record login events

Logs login events.

Java

Dfinery.getInstance().logEvent(DFEvent.LOGIN)

Swift

Dfinery.shared().logEvent(DFEvent.LOGIN)

Javascript

Dfinery.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.

Java

Dfinery.getInstance().logEvent(DFEvent.LOGOUT)

Swift

Dfinery.shared().logEvent(DFEvent.LOGOUT)

Javascript

Dfinery.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.

Java

DfineryProperties.resetIdentity();

Swift

Dfinery.shared().resetIdentity()

Javascript

Dfinery.resetIdentity()

EXTERNAL_IDLogin using existing

This 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.

Java

DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "A")

Swift

Dfinery.shared().setIdentity(key: DFIdentity.EXTERNAL_ID, value: "A")

Javascript

Dfinery.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.

Java

Dfinery.getInstance().logEvent(DFEvent.LOGIN)

Swift

Dfinery.shared().logEvent(DFEvent.LOGIN)

Javascript

Dfinery.logEvent(DFEvent.LOGIN)

EXTERNAL_IDLog in using another

This 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.

Java

DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "B")

Swift

Dfinery.shared().setIdentity(key: DFIdentity.EXTERNAL_ID, value: "B")

Javascript

Dfinery.setIdentity(DFIdentity.EXTERNAL_ID, "B")

2. Setting up a user profile

The user profile is reflected to the identified user B.

Java

DfineryProperties.setUserProfile(DFUserProfile.GENDER, DFGender.FEMALE)
DfineryProperties.setUserProfile(DFUserProfile.MEMBERSHIP, "VVIP")
...

Swift

Dfinery.shared().setUserProfile(key: DFUserProfile.GENDER, value: DFGender.FEMALE)
Dfinery.shared().setUserProfile(key: DFUserProfile.MEMBERSHIP, value: "VVIP")
...

Javascript

Dfinery.setUserProfile(DFUserProfile.GENDER, DFGender.FEMALE)
Dfinery.setUserProfile(DFUserProfile.MEMBERSHIP, "VVIP")
...

3. Record login events

The flow of events changes to the flow of events for the newly identified user B.

Java

Dfinery.getInstance().logEvent(DFEvent.LOGIN)

Swift

Dfinery.shared().logEvent(DFEvent.LOGIN)

Javascript

Dfinery.logEvent(DFEvent.LOGIN)

---

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.