고객 프로필
고객 프로필은 특정 사용자에 대한 정보를 찾는 데 유용한 방법입니다. 사용자와 관련된 모든 영구 데이터는 해당 고객 프로필에 저장됩니다.
프로필 액세스
사용자의 프로필에 액세스하려면 사용자 검색 페이지로 이동하여 다음 중 하나로 사용자를 검색합니다:
- 외부 사용자 ID
- Braze ID
- 이메일
- 전화번호
- 푸시 토큰
- “[user_alias]:[alias_name]” 형식의 사용자 별칭(예: “amplitude_id:user_123”)
일치하는 항목이 발견되면 Braze SDK로 해당 사용자에 대해 기록한 정보를 확인할 수 있습니다. 검색 결과에 여러 고객 프로필이 반환되는 경우 각 프로필을 개별적으로 병합하거나 대량 사용자 병합을 수행할 수 있습니다. 전체 안내는 중복 사용자 병합을 참조하세요.

전화번호로 검색할 때 E.164 형식으로 변환됩니다. 전화번호를 E.164 형식으로 변환할 수 없는 사용자(예: 국가 코드 또는 지역 코드가 유효하지 않은 경우)는 전화번호로 검색할 수 없습니다.

사용 사례
고객 프로필은 사용자의 참여 이력, Segment 멤버십, 기기 및 운영체제에 대한 정보에 쉽게 액세스할 수 있으므로 문제 해결 및 테스트에 유용한 리소스입니다.
예를 들어, 사용자가 문제를 보고했는데 어떤 기기와 운영체제를 사용하는지 확실하지 않은 경우 개요 탭을 사용하여 이 정보를 찾을 수 있습니다(이메일 또는 사용자 ID가 있는 경우). 또한 사용자의 언어를 확인할 수 있으며, 이는 예상대로 작동하지 않는 다국어 Campaign의 문제를 해결할 때 도움이 될 수 있습니다.
참여 탭을 사용하여 특정 사용자가 Campaign을 수신했는지 확인할 수 있습니다. 또한 해당 사용자가 Campaign을 수신한 경우 언제 수신했는지 확인할 수 있습니다. 사용자가 특정 Segment에 포함되어 있는지, 푸시, 이메일 또는 둘 다에 옵트인했는지도 확인할 수 있습니다. 이 정보는 문제 해결 목적으로 유용합니다. 예를 들어, 사용자가 수신해야 할 Campaign을 수신하지 못하거나 수신하지 않아야 할 Campaign을 수신하는 경우 이 정보를 확인해야 합니다.
고객 프로필의 구성 요소
고객 프로필에는 네 가지 주요 섹션이 있습니다.
- 개요: 사용자에 대한 기본 정보, 세션 데이터, 커스텀 속성, 커스텀 이벤트, 구매, 사용자가 마지막으로 로그인한 최근 기기.
- 참여: 사용자의 연락처 설정, 수신한 Campaigns, Segments, 커뮤니케이션 통계, 설치 경로, 무작위 버킷 번호에 대한 정보.
- 메시징 이력: 지난 30일 동안 이 사용자에 대한 최근 메시징 관련 이벤트.
- 기능 플래그 자격: 롤아웃, 캔버스 단계 및 실험 전반에서 사용자가 현재 자격이 있는 기능 플래그를 확인합니다.
개요 탭
개요 탭에는 사용자에 대한 기본 정보와 앱 또는 웹사이트와의 상호작용이 포함되어 있습니다.
| 개요 카테고리 | 포함 내용 |
|---|---|
| 프로필 | 성별, 연령대, 위치, 언어, 로캘, 시간대, 생일. |
| 세션 개요 | 세션 수, 첫 번째 및 마지막 세션 시점, 어떤 앱에서 발생했는지. |
| 커스텀 속성 | 이 사용자에게 귀속된 커스텀 속성과 관련 값(중첩 커스텀 속성 포함). |
| 최근 기기 | 로그인한 기기 수, 각 기기의 세부 정보, 관련 광고 ID(있는 경우). |
| 커스텀 이벤트 | 이 사용자가 수행한 커스텀 이벤트, 수행 횟수, 각 이벤트를 마지막으로 수행한 시점. |
| 구매 | 이 사용자에게 귀속된 평생 매출, 마지막 구매, 총 구매 횟수, 각 구매 목록. |
이 데이터에 대한 자세한 내용은 SDK 데이터 수집을 참조하세요.

참여 탭
참여 탭에는 Braze를 사용하여 전송한 메시지와 사용자의 상호작용에 대한 정보가 포함되어 있습니다.
| 참여 카테고리 | 포함 내용 |
|---|---|
| 연락처 설정 | 이메일, SMS, 푸시의 구독 상태와 이 세 채널에 대해 사용자가 연결된 구독 그룹. 이 섹션에는 푸시 토큰에 대한 체인지로그 정보도 포함됩니다. 구독 및 옵트인 설정 방법에 대한 자세한 내용은 이메일, SMS, 푸시를 참조하세요. |
| 수신한 Campaigns | 수신한 Campaigns는 채널별 전송 및 조회 시점을 반영합니다. 대부분의 채널은 Braze가 메시지를 전달 공급자에게 전달할 때 전송을 기록하며, 메시지가 최종적으로 전달되지 않더라도 기록됩니다. Content Cards는 다릅니다. Campaign은 사용자가 앱에서 카드를 조회한 후에만 여기에 표시됩니다. 채널별 세부 내용은 수신한 Campaigns에 Campaign이 표시되는 시점을 참조하세요. 메시지가 수신, 열림 또는 클릭되면 Braze는 상호작용을 기록한 프로필과 동일한 채널 식별자를 공유하는 모든 프로필의 데이터를 업데이트합니다(예: 이메일의 경우 동일한 이메일 주소, SMS 또는 WhatsApp의 경우 동일한 전화번호). 메시지를 수신, 열람 또는 클릭한 사람과 식별자를 공유하는 사용자는 원래 Campaign에 포함되지 않았거나 메시지를 직접 전송받지 않았더라도 이 필터에 일치할 수 있습니다. 목록에서 Campaign을 선택하여 확인합니다. |
| Segments | 이 사용자가 포함된 Segments. 목록에서 Segment를 선택하여 확인합니다. |
| 커뮤니케이션 통계 | 이 사용자가 각 채널에서 마지막으로 메시지를 수신한 시점. |
| 설치 경로 | 사용자가 앱을 설치한 방법과 시기에 대한 정보. 사용자 설치 이해에서 자세히 알아보세요. |
| 기타 | 사용자의 무작위 버킷 번호. |
| 수신한 Canvas 메시지 | 이 사용자가 수신한 Canvas 메시지와 수신 시점. 전송 시점은 수신한 Campaigns와 동일한 채널 규칙을 따릅니다. 수신한 Campaigns에 Campaign이 표시되는 시점을 참조하세요. 메시지가 수신, 열림 또는 클릭되면 Braze는 상호작용을 기록한 프로필과 동일한 채널 식별자를 공유하는 모든 프로필의 데이터를 업데이트합니다(예: 이메일의 경우 동일한 이메일 주소, SMS 또는 WhatsApp의 경우 동일한 전화번호). 메시지를 수신, 열람 또는 클릭한 사람과 식별자를 공유하는 사용자는 원래 Campaign에 포함되지 않았거나 메시지를 직접 전송받지 않았더라도 이 필터에 일치할 수 있습니다. 목록에서 메시지를 선택하여 확인합니다. |
| 예측 | 이 사용자에 대한 고객이탈 예측 및 이벤트 예측 점수. |
수신한 Campaigns에 Campaign이 표시되는 시점
일반적으로 Braze는 메시지 전송을 시도한 후 수신한 Campaigns에 Campaign을 표시합니다. 사용자의 기기 또는 받은편지함에 전달되지 않아도 전송이 기록됩니다. 수신한 Canvas 메시지도 각 Canvas 메시지 유형에 대해 동일한 채널별 규칙을 따릅니다.
- 이메일: Braze는 메시지가 이메일 서비스 공급자(ESP)에 전달될 때 전송을 기록합니다. 전달 후에는 Liquid 로직, 사용량 제한 또는 사용자가 도달 불가로 표시되어 메시지가 중단되지 않습니다. 이후 이벤트는 일반적으로 전달 또는 반송입니다.
- 푸시: Braze는 메시지가 푸시 공급자(예: Apple Push Notification service(APNs) 또는 Firebase Cloud Messaging(FCM))에 전달될 때 전송을 기록합니다. 공급자는 일반적으로 즉시 전달을 시도하며, 기기를 사용할 수 없는 경우(예: 오프라인) 메시지가 만료될 때까지 재시도할 수 있습니다.
- 인앱 메시지: Braze는 Campaign이 시작될 때 전송을 기록합니다.
- Content Cards: Braze가 전송 이벤트를 기록하는 시점은 전달 유형과 카드 생성 설정에 따라 다릅니다. Content Cards Campaign은 사용자가 앱에서 카드를 조회한 후에만 고객 프로필의 수신한 Campaigns에 표시됩니다. 전체 세부 내용은 Content Cards 보고서 문서의 전송이 기록되는 시점 및 수신한 Campaigns 및 리타겟팅 필터를 참조하세요.
- SMS, WhatsApp, 웹훅: Braze는 메시지가 해당 채널의 전달 경로에 진입할 때 전송을 기록합니다(예: SMS 또는 WhatsApp 공급자, 또는 웹훅 엔드포인트).

이 설명은 수신한 Campaigns에 대해 전송이 기록되는 시점을 다룹니다. 이는 메시지가 공급자에 도달하기 전에 메시지를 중지할 수 있는 메시지 중단과는 별개입니다.

메시징 이력 탭
고객 프로필의 메시지 이력 탭에는 지난 30일 동안 개별 사용자에 대한 최근 메시징 관련 이벤트(약 40개)가 표시됩니다. 이러한 이벤트에는 사용자에게 전송된 메시지, 수신한 메시지, 상호작용한 메시지 등이 포함됩니다.

이 탭의 데이터는 사용자가 병합된 후에는 업데이트되지 않습니다. 또한 API를 통해 전송된 메시지와 관련된 이벤트(예: /messages/send 엔드포인트)는 해당 전송에 Campaign ID가 지정되지 않은 경우 이 탭에 표시되지 않습니다.

이벤트 보기 및 이해
메시징 이력 테이블의 각 이벤트에 대해 메시징 채널, 이벤트 유형, 이벤트 발생 타임스탬프, 관련 Campaign 또는 Canvas 메시지, 사용자의 기기 데이터를 확인할 수 있습니다. 특정 이벤트를 필터링하려면 필터를 클릭하고 목록에서 이벤트를 선택합니다.
메시지 참여 이벤트
다음 메시지 참여 이벤트는 이메일, SMS, 푸시, 인앱 메시지, Content Cards, 웹훅에 사용할 수 있습니다. 특정 이벤트가 추적되는 방법에 대한 자세한 내용은 메시지 참여 이벤트 용어집을 참조하세요.
| 채널 | 사용 가능한 참여 이벤트 |
|---|---|
| 이메일 | 반송 클릭 지연 이벤트 전달 스팸으로 표시 열기(이메일 열기 이벤트에 대한 참고 사항 참조) 전송 소프트바운스 탈퇴 |
| SMS | 통신사 전송 전달 전달 실패 인바운드 수신 거부 전송 |
| 푸시 | 반송 영향받은 열기 iOS 포그라운드 열기 전송 |
| 인앱 메시지 | 클릭 노출 횟수 |
| Content Cards | 클릭 해제 노출 횟수 전송 |
| 웹훅 | 전송 |
| 중단 전달 실패 최대 게재빈도 설정 인바운드 수신 읽음 전송 |
메시지 중단 이벤트
메시지 중단 이벤트는 사용자에게 전송된 메시지가 Liquid 또는 연결된 콘텐츠의 조건 로직이나 Liquid 렌더링 시간 초과로 인해 중단된 경우 발생합니다.
중단 이벤트는 다음 채널에서 사용할 수 있습니다:
- 이메일
- SMS
- 푸시
- 웹훅
중단 이벤트는 현재 인앱 메시지 및 Content Cards에서는 사용할 수 없습니다.
최대 게재빈도 설정 이벤트
최대 게재빈도 설정 이벤트는 사용자가 메시지를 수신할 자격이 있지만 최대 게재빈도 설정 설정으로 인해 실제로 수신하지 못하는 경우 발생합니다. 설정 > 최대 게재빈도 설정 규칙에서 최대 게재빈도 설정을 커스터마이즈할 수 있습니다.
빈 대상
일부 메시지 전송은 메시징 이력에 빈 대상(“—”으로 표시)으로 나타날 수 있습니다. 이는 Content Cards 및 웹훅과 같은 일부 채널이 메시지 전송 시 기기 데이터를 수집하지 않기 때문입니다.
Content Cards 전송은 카드를 볼 수 있게 되었을 때 기록됩니다. Content Cards는 여러 기기에서 볼 수 있으므로 전송 시 기기 데이터가 기록되지 않습니다. 대신 이 정보는 노출 시(카드가 실제로 조회될 때) 기록됩니다. 웹훅은 시스템 엔드포인트(기기가 아닌)로 전송되므로 기기 데이터가 해당되지 않습니다.
이메일 열기 이벤트에 대한 참고 사항
이메일 열기 추적은 Braze를 포함한 모든 도구에서 오류가 발생하기 쉽습니다. 다양한 이메일 클라이언트에서 제공하는 개인정보 보호 기능이 이미지의 자동 로딩을 차단하거나 서버에서 사전에 로딩하기 때문에 이메일 열기 이벤트는 거짓 양성과 거짓 음성 모두에 취약합니다.
이메일 열기 통계는 집계적으로 유용할 수 있지만(예: 다른 제목란의 효과를 비교하는 경우), 개별 사용자에 대한 개별 열기 이벤트가 의미 있다고 가정해서는 안 됩니다.
메시지 이력 탭에서 특정 필드가 비어 있는 이유는 무엇인가요?
다음 시나리오에서 사용자의 메시지 이력 탭에 일부 필드가 없을 수 있습니다:
- 전송된 메시지에 대한 데이터가 누락된 이벤트는 해당 Campaign에 메시지 변형이 없음을 나타냅니다.
- Campaign/Canvas 및 전송된 메시지에 대한 데이터가 누락된 이벤트는
campaign_id및message_variation_id를 지정하지 않은 API Campaign(API 트리거 Campaign이 아닌)에서 전송된 메시지임을 나타냅니다. 이러한 필드는 선택 사항이며 요청 본문에서 생략될 수 있습니다. 이러한 필드가 지정되면 해당 정보가 메시지 이력 로그에 채워집니다.- 특정 메시지가 메시징 이력에는 완전히 누락되어 있지만 수신한 Campaigns 로그에 나타나는 경우, 사용자가 현재 사용자로 식별되기 전에 Campaign을 수신했을 가능성이 높습니다. 기존 프로필이 분리된 경우 수신한 Campaigns 로그는 이전되지만 메시징 이력은 이전되지 않습니다.
- Campaign/Canvas에 대한 데이터가 누락된 경우 수동 테스트가 전송되었을 수 있습니다. 수동 테스트는 메시징 이력 탭에 기록되지만 전송된 Campaign 또는 Canvas는 기록되지 않습니다.