사용자 ID 설정
교차 디바이스 추적 및 사용자 수준 데이터 보고를 활성화하려면 내부 사용자 ID를 Singular에 전송하세요.
참고: Singular의 크로스 디바이스 솔루션을 사용하는 경우, 모든 플랫폼에서 사용자 ID를 수집해야 합니다.
사용자 ID 요구 사항
개인정보 보호 및 모범 사례
사용자 ID 추적을 구현할 때 다음 가이드라인을 준수하여 개인정보 보호 규정을 준수하고 적절한 교차 디바이스 측정을 보장하세요.
- PII 금지: 사용자 ID는 이메일 주소, 사용자 이름 또는 전화번호와 같은 개인 식별 정보(PII)를 노출해서는 안 됩니다. 퍼스트 파티 데이터에 고유한 해시값을 사용하세요.
- 플랫폼 간 일관성: 정확한 기기 간 측정을 위해 사용자 ID 값은 모든 플랫폼(웹/모바일/PC/콘솔/오프라인)에서 캡처하는 동일한 내부 식별자이어야 합니다.
- 퍼스트 파티 데이터: 사용자 수준 내보내기, ETL 및 내부 BI 포스트백(구성된 경우)에 사용자 ID가 포함됩니다. 사용자 ID는 퍼스트 파티 데이터이며 타사와 공유되지 않습니다.
-
지속성: 사용자 ID는
unsetCustomUserId()을 사용하여 명시적으로 설정 해제하거나 앱이 제거될 때까지 지속됩니다. 앱을 닫거나 다시 시작해도 사용자 ID는 지워지지 않습니다.
구현 개요
사용자 ID를 설정하는 시기
setCustomUserId() 을 사용하여 사용자 식별자를 설정하고 unsetCustomUserId() 을 사용하여 로그아웃 중에 사용자 식별자를 지웁니다.
모범 사례: 여러 사용자가 하나의 디바이스를 공유하는 경우 로그인 시 setCustomUserId(), 로그아웃 시 unsetCustomUserId() 을 호출하는 로그아웃 플로우를 구현하세요.
앱이 열릴 때 사용자 ID를 이미 알고 있는 경우 Singular SDK를 초기화하기 전에 setCustomUserId() 을 호출하면 Singular가 첫 번째 세션에서 사용자 ID를 수신합니다. 그러나 일반적으로 사용자가 등록하거나 로그인할 때까지 사용자 ID를 사용할 수 없으며, 이 경우 등록 또는 인증 흐름이 완료된 후 setCustomUserId() 을 호출하세요.
SDK 메서드
사용자 지정 사용자 아이디 설정
교차 디바이스 추적 및 사용자 수준 보고를 위해 내부 사용자 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;사용자 지정 사용자 ID 설정 해제
사용자가 로그아웃할 때 사용자 ID를 지워 다중 사용자 디바이스에 대한 정확한 세션 추적을 보장합니다.
// Unset the user ID on logout
Singular.unsetCustomUserId()// Unset the user ID on logout
[Singular unsetCustomUserId];메소드 서명:
+ (void)unsetCustomUserId;고급 기능
사용자 지정 사용자 ID 디바이스 매핑
서버 간 연동을 위해 사용자 ID를 Singular의 모바일 디바이스 추적 식별자에 매핑합니다.
중요: 이 고급 엔터프라이즈 기능은 예외적인 경우에만 사용할 수 있습니다. 구현하기 전에 Singular 솔루션 엔지니어와 상담하세요.
Singular는 서버 간 연동을 통해 추가 모바일 이벤트 추적 데이터를 수신할 수 있습니다. 이 기능을 활용하려면 사용자 ID를 Singular의 모바일 디바이스 추적 식별자에 매핑해야 합니다.
참고: 이 메서드는 Singular SDK를 초기화한 후 또는 사용자 ID를 확보한 후 가능한 한 빨리 호출하세요.
구현
setDeviceCustomUserId() 을 사용하여 사용자 지정 사용자 ID를 설정하고 이를 Singular의 추적 식별자에 매핑합니다.
// Map user ID to device identifier for S2S integration
Singular.setDeviceCustomUserId("custom_user_id")// Map user ID to device identifier for S2S integration
[Singular setDeviceCustomUserId:@"custom_user_id"];메서드 서명:
+ (void)setDeviceCustomUserId:(NSString *)customUserId;설명: 사용자 지정 사용자 ID(로그인과 동일)를 설정하고 이를 서버 간 이벤트 어트리뷰션을 위한 Singular의 추적 식별자에 매핑합니다.