유저 ID 설정

내부 유저 ID를 Singular에 전송하여 크로스 디바이스 트래킹과 유저 레벨 데이터 보고를 활성화하세요.

유저 ID 요구사항

개인정보 및 모범 사례

개인정보 보호 준수와 정확한 크로스 디바이스 측정을 보장하려면 유저 ID 트래킹을 구현할 때 다음 지침을 따르세요.

• PII 금지: 유저 ID는 이메일 주소, 유저명, 전화번호 등 개인 식별 정보(PII)를 노출해서는 안 됩니다. 자사 데이터에 고유한 해시 값을 사용하세요.
• 플랫폼 간 일관성: 유저 ID 값은 정확한 크로스 디바이스 측정을 위해 모든 플랫폼(Web/Mobile/PC/Console/Offline)에서 수집하는 동일한 내부 식별자여야 합니다.
• 자사 데이터: Singular는 유저 ID를 유저 레벨 익스포트, ETL, 내부 BI 포스트백(구성된 경우)에 포함합니다. 유저 ID는 자사 데이터이며 제3자와 공유되지 않습니다.
• 지속성: 유저 ID는 unsetCustomUserId() 를 사용해 명시적으로 해제하거나 앱이 삭제될 때까지 유지됩니다. 앱을 종료하거나 재시작해도 유저 ID는 초기화되지 않습니다.

구현 개요

유저 ID를 설정해야 하는 시점

유저 식별자를 설정하려면 setCustomUserId() 를, 로그아웃 시 해제하려면 unsetCustomUserId() 를 사용하세요.

앱이 열릴 때 이미 유저 ID를 알고 있다면, Singular SDK를 초기화하기 전에 setCustomUserId() 를 호출하세요. 이를 통해 첫 세션부터 Singular가 유저 ID를 받을 수 있습니다. 다만, 유저 ID는 일반적으로 유저가 등록하거나 로그인할 때까지 사용할 수 없으므로 등록 또는 인증 플로우가 완료된 후 setCustomUserId() 를 호출하세요.

SDK 메서드

사용자 지정 유저 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");

메서드 시그니처:

public static void setCustomUserId(String customUserId);

사용자 지정 유저 ID 해제

여러 유저가 사용하는 디바이스에서 정확한 세션 트래킹을 보장하려면 유저가 로그아웃할 때 유저 ID를 초기화하세요.

// Unset the user ID on logout
Singular.unsetCustomUserId()

// Unset the user ID on logout
Singular.unsetCustomUserId();

메서드 시그니처:

public static void unsetCustomUserId();