문서

사용자 지정 사용자 ID 설정

모든 플랫폼에서 크로스 디바이스 추적 및 사용자 수준 데이터 보고를 활성화하려면 내부 사용자 ID를 Singular로 전송하세요.

참고: Singular의 크로스 디바이스 솔루션을 사용하는 경우, 모든 플랫폼에서 사용자 ID를 수집해야 합니다.

사용자 ID 요구 사항

개인정보 보호 및 모범 사례

사용자 ID 추적을 구현할 때 다음 가이드라인을 준수하여 개인정보 보호 규정을 준수하고 적절한 교차 디바이스 측정을 보장하세요.

PII 금지: 사용자 ID는 이메일 주소, 사용자 이름 또는 전화번호와 같은 개인 식별 정보(PII)를 노출해서는 안 됩니다. 퍼스트 파티 데이터에 고유한 해시값을 사용하세요.
플랫폼 간 일관성: 정확한 기기 간 측정을 위해 사용자 ID 값은 모든 플랫폼(웹/모바일/PC/콘솔/오프라인)에서 캡처하는 동일한 내부 식별자이어야 합니다.
퍼스트 파티 데이터: 사용자 수준 내보내기, ETL 및 내부 BI 포스트백(구성된 경우)에 사용자 ID가 포함됩니다. 사용자 ID는 퍼스트 파티 데이터이며 타사와 공유되지 않습니다.
지속성: 사용자 ID는 UnsetCustomUserId 을 사용하여 명시적으로 설정 해제하거나 앱을 제거할 때까지 지속됩니다. 앱을 닫거나 다시 시작해도 사용자 ID는 지워지지 않습니다.

모범 사례: 여러 사용자가 하나의 디바이스를 공유하는 경우 로그인 시 odedeSetCustomUserId를 호출하고 로그아웃 시 UnsetCustomUserId 을 호출하는 로그아웃 플로우를 구현하세요.

구현 개요

사용자 아이디를 설정하는 시기

SetCustomUserId 을 사용하여 사용자 식별자를 설정하고 UnsetCustomUserId 을 사용하여 로그아웃 중에 사용자 식별자를 지웁니다.

앱이 열릴 때 사용자 ID를 알고 있는 경우 Singular SDK를 초기화하기 전에 SetCustomUserId 을 호출하세요. 이렇게 하면 Singular가 첫 번째 세션에서 사용자 ID를 수신합니다. 그러나 일반적으로 사용자가 등록하거나 로그인할 때까지 사용자 ID를 사용할 수 없으며, 이 경우 등록 또는 인증 흐름이 완료된 후 SetCustomUserId 을 호출하세요.

SDK 메서드

사용자 지정 사용자 아이디 설정

교차 디바이스 추적 및 사용자 수준 보고를 위해 내부 사용자 ID를 Singular로 전송합니다.

// Set the user ID after login or registration
FString UserId = TEXT("user_abc123xyz");
USingularSDKBPLibrary::SetCustomUserId(UserId);
UE_LOG(LogTemp, Log, TEXT("Custom user ID set: %s"), *UserId);

메소드 서명:

static void SetCustomUserId(FString customUserId);

타이밍: 앱이 열릴 때 사용자 ID를 알고 있는 경우 SDK를 초기화하기 전에 SetCustomUserId 으로 호출하세요. 그렇지 않은 경우 사용자 등록 또는 로그인이 완료된 후에 호출하세요.