사용자 (User ID)

User ID는 각 사용자에게 할당되는 고유 식별자로, 모든 기기에서 일관된 사용자 데이터를 유지합니다. 이를 통해 잠재고객에게 모든 기기에서 원활한 사용자 경험을 제공할 수 있습니다.

사용자와 기기는 어떻게 관련되나요?

각 사용자에게는 User ID라는 고유 식별자가 할당됩니다. User ID는 여러 기기에 연결될 수 있어, 사용자가 기기를 바꾸더라도 비즈니스가 사용자와 계속 연결될 수 있도록 합니다. 이를 통해 타겟 메시지가 사용자가 사용하는 모든 기기에서 의도한 사용자에게 도달하도록 보장합니다.

사용자(User ID)는 독립적인 개체가 아니며, 연결된 기기의 존재에 의존합니다. 마지막으로 연결된 기기가 제거되거나 다른 사용자와 연결되면 해당 사용자는 시스템에서 자동으로 삭제됩니다.

사용자(User ID)는 또한 여러 기기를 그룹화할 수 있는 개체로 기능하며, 각 기기에는 고유한 하드웨어 ID(HWID)가 있습니다.

User ID와 각각 고유한 하드웨어 ID를 가진 여러 기기 간의 관계를 보여주는 다이어그램

사용자당 기기 제한

각 사용자는 자신의 User ID에 최대 20개의 기기를 연결할 수 있습니다. 21번째 기기가 등록되면 시스템은 공간을 확보하기 위해 기존 기기 중 하나를 자동으로 제거합니다.

제거할 기기는 어떻게 선택되나요

연결된 모든 기기가 이메일 전용인 경우, 무작위 이메일 기기가 제거됩니다.
그렇지 않은 경우, 시스템은 마지막 앱 실행 시간을 기준으로 가장 오래된 비-이메일 기기를 찾아 제거합니다.
비교할 활동 데이터가 없는 경우(예: 실제 앱 사용 없이 API를 통해 기기가 추가된 경우), 무작위 비-이메일 기기가 제거됩니다.

이를 통해 가장 최근에 활동한 기기는 계정에 연결된 상태를 유지하고, 오래되고 비활성 상태인 기기는 자동으로 정리됩니다.

사용자 유형

사용자에는 익명 사용자와 알려진 사용자 두 가지 유형이 있습니다. 익명 사용자는 User ID가 기기 HWID와 동일하며, 나중에 실제 User ID로 대체될 수 있습니다.

알려진 사용자는 고유한 User ID를 가집니다. /registerDevice API 호출을 통해 새 기기를 등록할 때 User ID를 지정할 수 있습니다.

User ID 획득 및 관리

Pushwoosh는 사용자에 액세스하고 관리하는 여러 가지 방법을 제공합니다:

사용자 생성

기본적으로 Pushwoosh SDK가 통합된 앱이 처음 실행되면 기기 HWID를 User ID로 설정합니다. 로그인 시 Pushwoosh SDK의 setUserID 메서드를 호출하여 특정 사용자와 기기를 연결하는 데 필요한 값을 설정할 수 있습니다. 사용자가 로그아웃하면 다른 setUserID 호출을 통해 이 값을 기본값(예: 초기 HWID 값)으로 재설정할 수 있습니다.

사용자 가져오기

특정 사용자 세그먼트에 대해 CSV 파일에서 User ID를 쉽게 가져올 수 있습니다. 자세한 지침은 세그먼트 가이드에서 확인하세요.

사용자 내보내기

User ID를 내보내려면 /exportSegment API 요청을 활용할 수 있으며, 이 요청은 데이터를 CSV 또는 JSON 형식으로 내보내는 옵션을 제공합니다.

기기 로그에서 User ID 액세스

User ID는 기기 로그에서도 직접 액세스할 수 있습니다. 단계별 지침은 콘솔 로그 및 기기 토큰을 얻는 방법 문서를 참조하세요.

사용자와 기기 태그

기기와 마찬가지로 사용자(User ID)도 자신의 태그 세트를 가질 수 있으며, 이 태그는 사용자의 특성에 따라 사용자와 기기를 분류하고 식별하는 레이블 역할을 합니다.

사용자별 태그 생성 방법

사용자별 태그를 설정하면 해당 태그는 사용자와 연결된 모든 기기에 자동으로 적용됩니다. 즉, 태그는 사용자 프로필에 연결되고 모든 기기에 반영됩니다.

Pushwoosh 제어판에서 사용자별 태그를 생성하려면 새 태그를 추가할 때 사용자별(User-specific) 확인란을 선택하세요. 태그를 사용자별로 표시하지 않으면 기기에만 연결됩니다.

사용자별 태그 생성을 위한 사용자별 확인란 옵션을 보여주는 Pushwoosh 제어판 태그 생성 양식

사용자 전환 관리

Pushwoosh 내에서 사용자 전환 관리는 두 가지 주요 시나리오를 포함합니다:

익명 사용자에서 알려진 사용자로 전환

익명 사용자가 알려진 사용자가 되면, 그들이 사용하던 기기는 새로운 사용자 프로필과 연결됩니다. 이 전환 과정에서 모든 기기 속성은 그대로 유지됩니다. 그러나 모든 사용자별 속성은 알려진 사용자 값으로 재설정되거나, 값이 없는 경우 기본값으로 설정된다는 점에 유의해야 합니다.

예를 들어, 게스트 사용자가 기본 설정으로 피트니스 추적 애플리케이션을 사용하고 있는 시나리오를 생각해 보겠습니다. 계정을 생성하면 기기 데이터는 변경되지 않습니다. 그러나 이름, 이메일, 맞춤형 목표와 같은 모든 사용자별 세부 정보는 알려진 사용자 값으로 재설정됩니다.

한 알려진 사용자에서 다른 사용자로 전환

Pushwoosh SDK의 setUserID를 사용하여 기기와 연결된 사용자가 변경되면, 해당 기기는 새로운 사용자 프로필과 연결됩니다.

Android 및 iOS용 User ID 설정에 대해 자세히 알아보세요.

/registerUser API 호출을 사용할 수도 있습니다.

이전 시나리오와 마찬가지로 기기 속성은 동일하게 유지되어 원활한 전환을 보장합니다. 그러나 사용자별 태그는 이제 새 사용자의 값에 할당됩니다. 이는 사용자 태그가 새 사용자의 프로필을 정확하게 반영하도록 하기 위함입니다.

예를 들어, 비디오 스트리밍 서비스의 시나리오를 생각해 보겠습니다. 등록된 사용자가 로그아웃하고 다른 등록된 사용자가 동일한 기기에서 로그인하면, 선호 언어 및 비디오 품질 설정과 같은 기기 설정은 유지됩니다. 그러나 시청 기록 및 추천과 같은 모든 사용자별 정보는 새 사용자에 맞게 변경됩니다.

사용자 관리를 위한 API 메서드

Pushwoosh는 애플리케이션 내에서 사용자를 관리하기 위한 여러 API 메서드를 제공합니다. 이러한 메서드를 이해하는 것은 효과적인 사용자 데이터 관리 및 타겟팅에 매우 중요합니다. 다음은 사용자의 상태나 속성을 변경하는 네 가지 주요 메서드입니다:

/applicationOpen

푸시 토큰이 없는 기기와 익명 사용자가 존재하지 않는 경우 생성합니다.
기기에 기기별 태그를 설정합니다.
사용자와 관련된 변경 사항은 처리하지 않습니다.

/registerDevice

푸시 토큰이 있는 기기와 사용자가 존재하지 않는 경우 생성합니다.
API 요청의 사용자와 기기를 연결합니다 (그렇지 않으면 익명 사용자).
지정된 모든 태그를 기기와 연결된 사용자 모두에게 할당합니다.

/registerUser

푸시 토큰이 없는 기기와 사용자가 존재하지 않는 경우 생성합니다.
기기 태그를 유지하면서 사용자 간에 기기를 전송합니다.

/setTags

푸시 토큰이 없는 기기와 익명 사용자가 존재하지 않는 경우 생성합니다.
기기에 기기 태그를 할당합니다.
요청에 제공된 사용자에게 사용자 태그를 할당합니다 (해당 사용자가 존재하는 경우).
이 메서드는 기기를 전송하지 않으므로 새로운 알려진 사용자를 생성할 수 없습니다 (새로운 알려진 사용자를 생성하려면 /registerUser 메서드를 사용할 수 있습니다).

사용자가 여러 기기와 연결된 경우, Customer Journey 중에 어떤 기기가 메시지를 받게 되나요?

사용자가 계정에 여러 기기를 연결한 경우, 메시지가 전달되는 방식은 Journey 유형에 따라 다릅니다:

잠재고객 기반 진입 및 웹훅 기반 진입 Journey

기본적으로 이러한 Journey에서는 메시지가 사용자와 연결된 가장 최근에 활동한 기기로 전송됩니다. 이를 통해 메시지가 참여할 가능성이 가장 높은 사용자에게 도달하도록 보장합니다.

트리거 기반 진입 Journey

기본적으로 메시지는 트리거링 작업이 마지막으로 발생한 기기로 전송됩니다. 이는 관련 사용자 활동이 발생한 기기에서 메시지를 전달함으로써 맥락과 관련성을 유지합니다.

모든 기기로 전송

그러나 이러한 기본 설정을 재정의하고 User ID와 연결된 모든 기기에 동시에 메시지를 보낼 수 있습니다. 이를 위해 메시지 설정에서 **옵션(Options)**으로 스크롤하여 **모든 사용자 기기로 전송(Send to all user devices)**을 켜세요.

옵션 섹션에서 모든 사용자 기기로 전송 토글 옵션을 보여주는 Customer Journey 메시지 설정

이 옵션은 사용자가 현재 어떤 기기를 사용하고 있는지에 관계없이 사용자에게 도달해야 하는 방송이나 긴급 알림에 유용할 수 있습니다.