사용자 (User ID)

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

사용자와 디바이스는 어떻게 관련되나요?

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

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

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

사용자 유형

사용자에는 익명 사용자와 알려진 사용자 두 가지 유형이 있습니다. 익명 사용자는 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 Control Panel에서 사용자별 태그를 생성하려면 새 태그를 추가할 때 User-specific 체크박스를 선택하세요. 태그를 사용자별로 표시하지 않으면 디바이스에만 연결됩니다.

사용자 전환 관리

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

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

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

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

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

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

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

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

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

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

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

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

1. /applicationOpen

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

2. /registerDevice

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

주의

잠재적인 경쟁 조건(여러 작업이 공유 데이터를 동시에 수정하려고 시도하는 경우)으로부터 보호하기 위해 /registerDevice를 /registerUser와 동시에 사용하지 마세요.

3. /registerUser

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

4. /setTags

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

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

사용자가 계정에 여러 디바이스를 연결한 경우, 메시지 전달 방식은 Journey 유형에 따라 달라집니다:

Audience 기반 진입 및 Webhook 기반 진입 Journey

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

트리거 기반 진입 Journey

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

모든 디바이스로 전송

그러나 이러한 기본 설정을 재정의하고 User ID와 연결된 모든 디바이스로 동시에 메시지를 보낼 수 있습니다. 이를 위해 메시지 설정에서 Options로 스크롤하여 Send to all user devices를 활성화하세요.

이 옵션은 사용자가 현재 사용 중인 디바이스에 관계없이 사용자에게 도달해야 하는 방송이나 긴급 알림에 유용할 수 있습니다.