Unity SDK - 사용자 ID 설정

문서

사용자 ID 설정

교차 디바이스 추적 및 사용자 수준 데이터 보고를 활성화하려면 내부 사용자 ID를 Singular에 전송하세요.

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

사용자 ID 요구 사항

개인정보 보호 및 모범 사례

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

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

구현 개요

사용자 ID를 설정하는 시기

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

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

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


SDK 메서드

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

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

C#
// Set the user ID after login or registration
SingularSDK.SetCustomUserId("custom_user_id");

메소드 서명:

public static void SetCustomUserId(string customUserId)

사용자 지정 사용자 ID 설정 해제

사용자가 로그아웃할 때 사용자 ID를 지워 다중 사용자 디바이스에 대한 정확한 세션 추적을 보장합니다.

C#
// Unset the user ID on logout
SingularSDK.UnsetCustomUserId();

메소드 서명:

public static void UnsetCustomUserId()