유저 ID 설정
내부 유저 ID를 Singular로 전송하여 크로스 디바이스 트래킹과 유저 수준의 데이터 리포팅을 활성화하세요.
참고: Singular의 크로스 디바이스 솔루션 을 사용하는 경우, 모든 플랫폼에서 유저 ID를 수집해야 합니다.
유저 ID 요구 사항
개인정보 보호 및 모범 사례
유저 ID 트래킹을 구현할 때 개인정보 보호 규정 준수와 올바른 크로스 디바이스 측정을 보장하기 위해 다음 지침을 따르세요.
- PII 사용 금지: 유저 ID는 이메일 주소, 사용자명, 전화번호와 같은 개인 식별 정보(PII)를 노출해서는 안 됩니다. 자사 데이터에 고유한 해시된 값을 사용하세요.
- 플랫폼 전반의 일관성: 유저 ID 값은 정확한 크로스 디바이스 측정을 위해 모든 플랫폼(웹/모바일/PC/콘솔/오프라인)에서 수집하는 동일한 내부 식별자여야 합니다.
- 자사 데이터: Singular는 유저 ID를 유저 수준 익스포트, ETL 및 내부 BI 포스트백(구성된 경우)에 포함합니다. 유저 ID는 자사 데이터이며 제3자와 공유되지 않습니다.
-
지속성:
유저 ID는
unsetCustomUserId()를 사용하여 명시적으로 해제하거나 앱이 삭제될 때까지 유지됩니다. 앱을 닫거나 재시작해도 유저 ID는 지워지지 않습니다.
구현 개요
유저 ID를 설정해야 하는 시점
유저 식별자를 설정하려면
setCustomUserId()
를, 로그아웃 시 이를 지우려면
unsetCustomUserId()
를 사용하세요.
모범 사례:
여러 유저가 Singular 디바이스를 공유하는 경우,
로그인 시
setCustomUserId()
를 호출하고 로그아웃 시
unsetCustomUserId()
를 호출하는 로그아웃 흐름을 구현하세요.
앱이 열릴 때 이미 유저 ID를 알고 있는 경우, Singular SDK를 초기화하기 전에
setCustomUserId()
를 호출하세요.
이렇게 하면 Singular가 첫 세션부터 유저 ID를 수신합니다. 그러나
일반적으로 유저가 등록하거나 로그인할 때까지 유저 ID를 사용할 수 없으며,
이 경우 등록 또는 인증 흐름이 완료된 후
setCustomUserId()
를 호출하세요.
SDK 메서드
Custom User ID 설정
크로스 디바이스 트래킹과 유저 수준 리포팅을 위해 내부 유저 ID를 Singular로 전송하세요.
// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")// Set the user ID after login or registration
[Singular setCustomUserId:@"custom_user_id"];메서드 시그니처:
+ (void)setCustomUserId:(NSString *)customUserId;
+setCustomUserId:
는
void
를 반환합니다. 호출 시점에는 성공/실패 신호가 없습니다. 유저 ID는
SDK가 전송하는 다음 세션 및 이벤트에 첨부됩니다.
이름이 유사한
+setDeviceCustomUserId:
는
__attribute__((deprecated))
로 표시되어 있으며 레거시 호환성을 위해서만 존재합니다. 새 코드에서는 항상
+setCustomUserId:
를 호출하세요.
Custom User ID 해제
멀티 유저 디바이스에서 정확한 세션 트래킹을 보장하기 위해 유저가 로그아웃할 때 유저 ID를 지우세요.
// Unset the user ID on logout
Singular.unsetCustomUserId()// Unset the user ID on logout
[Singular unsetCustomUserId];메서드 시그니처:
+ (void)unsetCustomUserId;