고객 사용자 ID 필드(Customer User ID, CUID)

요약: CUID를 사용하면 서로 다른 디바이스, 미디어소스 또는 채널에서 동일한 사용자의 이벤트를 그룹화할 수 있습니다.

CUID란 무엇입니까?

고객 사용자 ID(CUID)는 고유한 사용자 식별자입니다. 일반적으로 사용자 등록 시 앱 소유자가 생성하고 설정합니다. CUID를 통해 앱 소유자는 다양한 디바이스에서 사용자 여정을 추적할 수 있습니다.

예시

두 개 이상의 기기를 사용하는 사용자는 앱 내에서 동일한 CUID를 갖습니다. 사용자가 모바일 또는 데스크톱 디바이스에서 이벤트를 수행할 때마다 이벤트가 CUID와 함께 캡처됩니다. 이를 통해 광고주는 디바이스의 데이터를 전체적인 사용자 보기로 결합할 수 있습니다.

몇 가지 사용 사례는 다음과 같습니다.

  • 동일한 사용자가 동일한 앱에서 여러 디바이스(휴대폰, 태블릿, TV, 데스크톱)에서 수행한 인앱 구매를 단일 보기로 결합할 수 있습니다.
  • 여러 플랫폼(데스크톱, 모바일, TV)에 설치된 게임의 사용자 성능을 이러한 플랫폼 간에 공유하여 전체적인 사용자 경험을 달성할 수 있습니다.

CUID 설정

가능한 한 많은 이벤트가 CUID 연결을 얻을 수 있도록 SDK 초기화 흐름에서 CUID를 가능한 한 빨리 설정하는 것이 좋습니다.

안드로이드에서 CUID 설정

CUID를 사용할 수 있게 되면 setCustomerUserId를 호출하여 설정할 수 있습니다. CUID는 설정된 후 발생하는 인앱이벤트에만 연결할 수 있습니다. 따라서 인스톨 이벤트는 startsetCustomerUserID 이전에 호출되면 CUID와 연결되지 않습니다.

CUID를 인스톨 이벤트와 연결

인스톨 이벤트를 CUID에 연결하는 것이 중요한 경우 start를 호출하기 전에 설정해야 합니다.

중요: start 전에 CUID를 설정하면 SDK가 설치 이벤트를 전송하지 못하도록 차단되어 어트리뷰션이 발생하지 않을 수 있습니다. 예를 들어 사용자가 애플리케이션을 처음 시작한 다음 SDK가 CUID를 설정하기 전에 종료되는 경우 이러한 상황이 발생할 수 있습니다.

안드로이드에서 start 메서드 및 CUID 설정은 앱 구현에 따라 전역 애플리케이션 클래스 또는 액티비티 클래스에서 실행할 수 있습니다. 자세한 내용은 SDK를 시작할 클래스 선택을 참조하십시오.

SDK가 애플리케이션 클래스에서 시작되는 경우

전역 애플리케이션 클래스에서 시작할 때 CUID를 인스톨 이벤트와 연결하려면 waitForCustomerUserId 메서드를 사용하여 인스톨 이벤트 전송을 지연해야 합니다. 이 방법은 CUID가 설정될 때까지 SDK를 대기 모드로 전환합니다.

참고: 어떤 이유로든 CUID 설정이 실패하면 SDK는 대기 모드로 유지되고 이벤트를 전송하지 않습니다.

SDK가 액티비티 클래스에서 시작되는 경우

액티비티 클래스에서 시작할 때 CUID를 인스톨 이벤트와 연결하려면 인스톨 이벤트 전송을 지연할 필요가 없습니다. setCustomerUserIdstart 이전에 호출하면 됩니다.

개발자 지침

개발자에게 다음 사항을 알립니다.

  • SDK가 전역 애플리케이션 클래스에서 시작되는 경우 waitForCustomerUserId를 사용하십시오.
  • 개발자 링크:
    • CUID를 설치 이벤트와 연결하려면 여기에서 참조하십시오.

iOS에서 CUID 설정

customerUserId 메서드를 사용하여 CUID를 설정합니다. start 메서드와 관련된 customerUserId 위치에 따라 어떤 이벤트가 CUID와 연결될 수 있는지 결정됩니다.

  • customerUserId시작 호출 전에 호출되는 경우 CUID가 인스톨 및 다음 인앱이벤트와 연결됩니다.
  • start 이후에 호출되는 경우 CUID는 CUID를 설정한 후 기록된 이벤트에만 연결됩니다.

개발자 지침

개발자에게 다음 링크를 참조하도록 하십시오.

CUID와 개인 정보 보호

앱스플라이어는 사용자의 프라이버시를 소중히 여기고 존중하며, 민감한 개인 데이터를 앱스플라이어 플랫폼으로 수집하거나 전송하는 것을 허용하지 않습니다.

사용자의 개인 정보를 보호하기 위해 사용자를 직접 식별하는 정보로 CUID를 설계할 수 없습니다. 여기에는 사회 보장 번호 또는 주민등록번호가 포함됩니다.

또한 설정된 CUID에 사용자의 이메일 주소 또는 전화번호가 포함되어 있는 경우, 해당 정보는 앱스플라이어로 전송할 때 항상 해시되어야 합니다. 개인 데이터가 포함된 해시되지 않은 CUID를 앱스플라이어에 보내는 것은 금지되어 있습니다.

더 읽어보기

로데이터 리포트의 CUID에 대한 자세한 내용은 사용자 여정 리포트를 참조하십시오.