고객 프로필 수명주기
이 문서에서는 Braze 고객 프로필 수명주기와 고객 프로필을 식별하고 참조하는 다양한 방법에 대해 설명합니다. 고객 생애주기를 더 잘 이해하고 싶다면 사용자 라이프사이클 매핑에 대한 Braze 학습 과정을 확인해 보세요.
사용자와 관련된 모든 영구 데이터는 고객 프로필에 저장됩니다. API를 통해 고객 프로필을 생성하거나 SDK에서 사용자를 인식한 후, 해당 프로필에 여러 매개변수를 할당하여 사용자를 식별하고 참조할 수 있습니다.
이러한 매개변수에는 다음이 포함됩니다:
braze_id(Braze에서 할당)external_idemailphone- 설정한 커스텀 사용자 별칭(개수 제한 없음)
익명 사용자 프로필
지정된 external_id가 없는 사용자를 익명 사용자라고 합니다. 예를 들어 웹사이트를 방문했지만 가입하지 않은 사용자 또는 모바일 앱을 다운로드했지만 프로필을 만들지 않은 사용자 등이 이에 해당할 수 있습니다.
처음에 SDK에 의해 사용자가 인식되면, Braze에서 자동으로 할당되고 편집할 수 없으며 기기별로 고유한 식별자인 braze_id가 연결된 익명 사용자 프로필이 생성됩니다. 이 식별자는 API를 통해 고객 프로필을 업데이트하는 데 사용할 수 있습니다.
식별된 사용자 프로필
앱에서 사용자를 인식할 수 있게 되면(사용자 ID 또는 이메일 주소를 제공함으로써) changeUser 메서드(웹, iOS, Android)를 사용하여 해당 사용자의 프로필에 external_id를 할당하는 것이 좋습니다. external_id를 사용하면 여러 기기에서 동일한 고객 프로필을 식별할 수 있습니다.
external_id 사용의 추가 이점은 다음과 같습니다:
- 여러 기기와 플랫폼에서 일관된 사용자 경험을 제공합니다(예: iPhone 앱의 충성도가 높은 사용자에게 Android 태블릿에서 이탈 사용자 알림을 보내지 않음).
- 사용자가 앱을 삭제했다가 다시 설치하거나 다른 기기에 앱을 설치할 때마다 새 고객 프로필을 생성하지 않도록 하여 분석의 정확성을 향상합니다.
- 사용자 데이터 엔드포인트를 사용하여 앱 외부의 소스에서 사용자 데이터를 가져오고, 메시징 엔드포인트를 사용하여 트랜잭션 메시지로 사용자를 타겟팅할 수 있습니다.
- 세그먼터 내에서 “테스트” 필터를 사용하여 개별 사용자를 검색하고, 사용자 검색 페이지에서 검색합니다.
외부 ID 관련 고려 사항
사용자 프로필에 external_id 을 할당하지 말고 고유하게 식별할 수 있도록 하세요. 사용자를 식별한 후에는 익명으로 되돌릴 수 없습니다.
external_id은 /users/external_ids/rename 엔드포인트를 사용하여 업데이트할 수 있습니다. 그러나 사용자의 세션 중에 다른 external_id를 설정하려는 모든 시도는 새로운 external_id가 연결된 새로운 고객 프로필을 생성합니다. 두 프로필 간에 데이터가 전달되지 않습니다.
이메일 또는 해시된 이메일을 외부 ID로 사용할 때의 위험
이메일 주소 또는 해시된 이메일 주소를 Braze 외부 ID로 사용하면 데이터 소스 전반에서 ID 관리를 간소화할 수 있지만, 사용자 개인정보 보호 및 데이터 보안에 대한 잠재적 위험을 고려하는 것이 중요합니다.
- 추측 가능한 정보: 이메일 주소는 쉽게 추측할 수 있어 공격에 취약합니다.
- 악용 위험: 악의적인 사용자가 웹 브라우저를 변조하여 다른 사람의 이메일 주소를 자신의 외부 ID로 전송하면 민감한 메시지나 계정 정보에 접근할 수 있습니다.
익명 사용자를 식별하면 어떻게 되나요?
익명 사용자를 식별하는 경우 두 가지 시나리오 중 하나가 발생할 수 있습니다:
1) 익명 사용자가 새로운 식별된 사용자가 됩니다: external_id가 아직 Braze에 존재하지 않는 경우, 익명 사용자는 새로 식별된 사용자가 되며 익명 사용자의 모든 속성과 기록을 그대로 유지합니다.
2) 익명 사용자가 이미 존재하는 사용자로 식별됩니다: external_id가 이미 Braze에 존재하는 경우, 이 사용자는 이전에 다른 기기(예: 태블릿) 또는 가져온 사용자 데이터 등 다른 방식으로 시스템에서 이미 식별된 것입니다.
즉, 이 사용자에 대한 고객 프로필이 이미 있다는 뜻입니다. 이 경우 Braze는 다음을 수행합니다:
- 익명 사용자를 고아화합니다
- 익명 프로필에서 식별된 고객 프로필에 아직 존재하지 않는 특정 고객 프로필 필드를 병합합니다
- 사용자 수가 부풀려지지 않도록 사용자 기반에서 익명 프로필을 제거합니다
익명 사용자와 알려진 사용자 모두 이름이 있는 경우 알려진 사용자의 이름이 유지됩니다. 알려진 사용자에게는 null 값이 있고 익명 사용자에게는 값이 있는 경우, 해당 값이 이러한 특정 고객 프로필 필드에 해당하면 익명 사용자의 값이 알려진 사용자의 프로필에 병합됩니다.
익명 프로필의 모든 데이터가 병합되는 것은 아닙니다. 푸시 토큰과 메시징 기록은 이전되며, 익명 프로필의 커스텀 속성, 커스텀 이벤트, 구매 기록은 식별된 고객 프로필에 해당 필드가 아직 존재하지 않는 경우에만 식별된 사용자에게 병합됩니다. 충돌하는 데이터가 있는 경우 식별된 사용자의 값이 유지됩니다. 이전되는 필드와 이전되지 않는 필드의 전체 목록은 병합 동작을 참조하세요.
고객 프로필에 external_id를 설정하는 방법에 대한 자세한 내용은 설명서(iOS, Android, 웹)를 참조하세요.
고아화된 사용자는 메시지를 수신할 수 없습니다.
사용자 별칭
Braze external_id 이외의 식별자로 사용자를 참조하려면 고객 프로필에 대해 사용자 별칭을 설정하세요. 고객 프로필에 설정된 별칭은 사용자의 braze_id 또는 external_id를 대체하는 것이 아니라 추가로 작동합니다. 고객 프로필에 설정할 수 있는 별칭의 개수에는 제한이 없습니다.
각 별칭은 별칭의 키를 정의하는 alias_label과 값을 정의하는 alias_name의 두 부분으로 구성된 키-값 페어로 작동합니다. 단일 라벨의 alias_name은 external_id와 마찬가지로 사용자 기반 전체에서 고유해야 합니다. 기존 라벨과 이름 조합으로 두 번째 고객 프로필을 업데이트하려고 하면 고객 프로필이 업데이트되지 않습니다.
사용자 별칭 업데이트
별칭은 설정된 후 사용자 데이터 엔드포인트를 사용하거나 SDK를 통해 새 이름을 전달하여 주어진 라벨에 대해 새 이름으로 업데이트할 수 있습니다. 그러면 해당 사용자의 데이터를 내보낼 때 사용자 별칭이 표시됩니다.

익명 사용자 태그 지정
사용자 별칭을 사용하면 익명 사용자에게 식별자를 태그할 수도 있습니다. 예를 들어, 사용자가 이커머스 사이트에 이메일 주소를 제공했지만 아직 가입하지 않은 경우, 해당 이메일 주소를 익명 사용자의 별칭으로 사용할 수 있습니다. 그런 다음 이러한 사용자는 별칭을 사용하여 내보내거나 API에서 참조할 수 있습니다.
익명 사용자 프로필에서 별칭의 동작
별칭이 있는 익명 사용자 프로필이 나중에 external_id로 인식되면 정상적인 식별된 고객 프로필로 취급되지만, 기존 별칭은 그대로 유지되며 해당 별칭으로 계속 참조할 수 있습니다.
사용자 별칭 검색
사용자의 별칭 이름과 라벨을 알고 있다면 사용자 검색에서 alias_label:alias_name 형식으로 사용자를 찾을 수 있습니다. 예를 들어, 이름이 alias_name: bobby_alias이고 라벨이 alias_label: m4pzOndtA-CnO0u인 별칭 전용 프로필이 있는 경우, m4pzOndtA-CnO0u:bobby_alias를 입력하여 이 사용자를 찾을 수 있습니다.
이 정보를 모르는 경우 Export user profile by identifier 엔드포인트를 호출하여 API 응답에서 사용자 별칭을 찾을 수 있습니다.
알려진 사용자 프로필에 별칭 설정하기
알려진 고객 프로필에 사용자 별칭을 설정하여 외부에서 알려진 다른 ID로 해당 사용자를 참조할 수도 있습니다. 예를 들어, 사용자가 Braze 내에서 참조하고자 하는 비즈니스 인텔리전스 도구 ID(예: Amplitude ID)를 가지고 있을 수 있습니다.
사용자 별칭을 설정하는 방법에 대한 자세한 내용은 각 플랫폼별 설명서(iOS, Android, 웹)를 참조하세요.

고객의 고객 프로필 수명주기가 어떻게 적용될지 파악하기 어려우신가요? 사용자 데이터 수집 모범 사례를 보려면 모범 사례를 방문하세요.
고급 사용 사례
SDK 및 API의 사용자 데이터 엔드포인트를 사용하여 기존 식별된 고객 프로필에 새 사용자 별칭을 설정할 수 있습니다. 그러나 알 수 없는 기존 고객 프로필에 대해서는 API를 통해 사용자 별칭을 설정할 수 없습니다.
이 과정에서 사용자 별칭도 병합됩니다. 그러나 고아화할 사용자와 대상 사용자 모두 동일한 라벨의 별칭을 가지고 있는 경우에는 대상 사용자의 별칭만 유지됩니다.
앱을 삭제했다가 다시 설치하면 해당 사용자에 대한 새로운 익명 braze_id가 생성됩니다.
사용자 ID 관련 문제 해결
모든 사용자 ID는 대시보드 내에서 테스트할 사용자를 찾고 식별하는 데 사용할 수 있습니다. Braze 대시보드에서 사용자를 찾으려면 테스트 사용자 추가를 참조하세요.
Braze는 세션 수가 5,000,000개가 넘는 사용자(“더미 사용자”)를 금지 또는 차단하며, 이러한 사용자는 일반적으로 잘못된 통합의 결과이므로 더 이상 해당 사용자의 SDK 이벤트를 수집하지 않습니다. 정당한 사용자에게 이러한 일이 발생한 경우 Braze 계정 매니저에게 연락하세요.
GitHub 에서 이 페이지를 편집합니다.