통합 ID 연동 시나리오

이 문서는 유저 식별 정보 설정으로 인한 유저 정보의 구성과 단말기 연결의 이해를 돕기 위해 가상의 시나리오를 예시로 들어 설명하는 문서입니다.

앱 최초 설치

SDK를 초기화 하기 위해 유저는 각 플랫폼 별 연동하기 가이드에 명시된 단계에 따라 적용해야 합니다.

유저 로그인

이 섹션은 익명의 유저 프로필 상태에서 식별된 유저 프로필로 전환되는 과정을 보여줍니다.

1. 유저 식별 정보 설정하기

로그인 이벤트를 기록하기 전에 유저를 구분할 값인 EXTERNAL_ID값을 유저 식별 정보에 설정 해줍니다. 이 과정을 통해 해당 유저는 익명의 유저 프로필 상태에서 식별된 유저 프로필로 전환되며 통합 ID가 생성되어 어떤 플랫폼에서든 이 유저를 통합 ID를 통해 특정할 수 있게 됩니다.

Java

DfineryProperties.setIdentity(DFIdentity.EXTERNAL_ID, "A")
//다른 식별 정보를 추가로 설정함으로써 유저 식별의 정확도를 높일 수 있습니다.
DfineryProperties.setIdentity(DFIdentity.EMAIL, "[e-mail]")
DfineryProperties.setIdentity(DFIdentity.PHONE_NO, "8201012345678")
...

Swift

Dfinery.shared().setIdentity(key: DFIdentity.EXTERNAL_ID, value: "A")
//다른 식별 정보를 추가로 설정함으로써 유저 식별의 정확도를 높일 수 있습니다.
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")
//다른 식별 정보를 추가로 설정함으로써 유저 식별의 정확도를 높일 수 있습니다.
Dfinery.setIdentity(DFIdentity.EMAIL, "[e-mail]")
Dfinery.setIdentity(DFIdentity.PHONE_NO, "8201012345678")

2. 유저 프로필 설정하기

식별된 유저 A에 해당하는 설정에 필요한 정보가 있을 경우 유저 프로필 설정을 통해 반영합니다.

유저 프로필은 임의의 키 값을 유저가 콘솔에서 설정해서 반영 가능합니다.

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. 로그인 이벤트 기록하기

로그인 이벤트를 기록합니다.

Java

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

Swift

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

Javascript

Dfinery.logEvent(DFEvent.LOGIN)

유저 로그아웃

이 섹션은 식별된 유저 A가 로그아웃을 하는 과정을 보여줍니다.

1. 로그아웃 이벤트 기록하기

로그아웃 이벤트를 기록합니다.

Java

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

Swift

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

Javascript

Dfinery.logEvent(DFEvent.LOGOUT)

2. 유저 식별 정보를 초기화하기 (선택사항)

만약 식별된 유저 A가 로그아웃한 이후 A에 대해 액션이 타게팅이 되기를 원치 않을 경우 resetIdentity() API를 호출함으로써 유저 식별 정보를 초기화 합니다.

유저 식별 정보를 초기화 할 경우 기존에 이어지고 있던 이벤트 흐름이 끊기고 단말기와 유저의 연결도 끊기게 되므로 호출에 주의하여 주시기 바랍니다.

만약 그래도 호출하신다면 수집된 이벤트의 반영을 위해 API 호출 전에 반영하고자 하는 이벤트를 먼저 호출한 후 호출하여 주시기를 바랍니다.

Java

DfineryProperties.resetIdentity();

Swift

Dfinery.shared().resetIdentity()

Javascript

Dfinery.resetIdentity()

기존 EXTERNAL_ID를 사용한 로그인

이 섹션은 통합 식별 정보를 설정한 이력이 있는 유저가 다시 같은 EXTERNAL_ID 값을 사용해서 로그인을 하는 과정을 보여줍니다.

1. 유저 식별 정보 설정하기

입력한 EXTERNAL_ID 값이 기존과 동일할 경우 기존에 생성되었던 식별된 유저 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. 로그인 이벤트 기록하기

이벤트의 흐름 또한 기존과 마찬가지로 식별된 유저 A의 이벤트 흐름이 계속해서 이어집니다.

Java

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

Swift

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

Javascript

Dfinery.logEvent(DFEvent.LOGIN)

다른 EXTERNAL_ID를 사용한 로그인

이 섹션은 통합 식별 정보를 설정한 이력이 있는 유저가 다른 EXTERNAL_ID 값을 사용해서 로그인을 하는 과정을 보여줍니다.

1. 유저 식별 정보 설정하기

입력한 EXTERNAL_ID 값이 기존과 다를 경우 SDK는 다른 유저로 판단해서 기존에 저장하고 있었던 통합 ID 정보를 모두 삭제하고 새로 설정하게 되며 단말기가 식별된 유저 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. 유저 프로필 설정하기

유저 프로필은 식별된 유저 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. 로그인 이벤트 기록하기

이벤트의 흐름은 새로이 식별된 유저 B의 이벤트 흐름으로 변경됩니다.

Java

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

Swift

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

Javascript

Dfinery.logEvent(DFEvent.LOGIN)

---

용어

익명의 유저 프로필

유저 식별 정보를 설정하지 않았을 경우 유저는 익명 유저로 취급됩니다. 예를 들어 웹사이트에 방문했지만 가입하지 않았거나 모바일 앱을 다운로드 했지만 프로필을 만들지 않은 유저가 될 수 있습니다.

처음에 SDK를 통해 유저가 인식되면 SDK에서 생성한 고유 식별자가 발급되어 익명의 유저 프로필이 생성됩니다.

식별된 유저 프로필

아래 식별 정보 유형 중 EXTERNAL_ID 값을 설정할 경우 DFINERY에서 식별된 유저로 취급되며 여러 장치에서 동일한 유저 프로필을 식별할 수 있게 됩니다. 또한 보다 명확한 유저 식별을 위해 유저 이메일, 전화번호 등의 정보를 추가로 설정할 수 있습니다.