고객 프로필

고객 프로필은 특정 사용자에 대한 정보를 찾는 데 유용한 방법입니다. 사용자와 관련된 모든 영구 데이터는 해당 고객 프로필에 저장됩니다.

프로필 접근

사용자의 프로필에 접근하려면 사용자 검색 페이지로 이동하여 다음 중 하나로 사용자를 검색합니다:

• 외부 사용자 ID
• Braze ID
• 이메일
• 전화번호
• 푸시 토큰
• “[user_alias]:[alias_name]” 형식의 사용자 별칭(예: “amplitude_id:user_123”)

일치하는 결과가 있으면 Braze SDK로 기록한 해당 사용자의 정보를 확인할 수 있습니다. 검색 결과에 여러 고객 프로필이 반환되는 경우 각 프로필을 개별적으로 병합하거나 일괄 사용자 병합을 수행할 수 있습니다. 전체 안내는 중복 사용자 병합을 참조하세요.

사용 사례

고객 프로필은 사용자의 인게이지먼트 이력, Segment 멤버십, 기기, 운영 체제에 대한 정보를 쉽게 확인할 수 있어 문제 해결 및 테스트에 유용한 리소스입니다.

예를 들어, 사용자가 문제를 보고했는데 어떤 기기와 운영 체제를 사용하고 있는지 확실하지 않은 경우, 개요 탭을 사용하여 이 정보를 확인할 수 있습니다(이메일 또는 사용자 ID가 있는 경우). 또한 사용자의 언어를 확인할 수 있는데, 이는 예상대로 작동하지 않는 다국어 Campaign을 문제 해결할 때 도움이 될 수 있습니다.

인게이지먼트 탭을 사용하여 특정 사용자가 Campaign을 수신했는지 확인할 수 있습니다. 또한 해당 사용자가 Campaign을 수신한 경우, 언제 수신했는지도 확인할 수 있습니다. 사용자가 특정 Segment에 속해 있는지, 푸시, 이메일 또는 둘 다에 옵트인했는지도 확인할 수 있습니다. 이 정보는 문제 해결 목적으로 유용합니다. 예를 들어, 사용자가 수신할 것으로 예상했던 Campaign을 수신하지 못하거나, 수신할 것으로 예상하지 않았던 Campaign을 수신한 경우 이 정보를 확인해야 합니다.

고객 프로필의 구성 요소

고객 프로필에는 다섯 가지 주요 섹션이 있습니다.

• 개요: 사용자에 대한 기본 정보, 세션 데이터, 커스텀 속성, 커스텀 이벤트, 구매 내역, 사용자가 마지막으로 로그인한 최근 기기 정보.
• 인게이지먼트: 사용자의 연락처 설정, 수신한 Campaigns, Segments, 커뮤니케이션 통계, 설치 경로, 무작위 버킷 번호에 대한 정보.
• 이벤트 기록: 최근 30일간의 커스텀 이벤트 및 구매 내역으로, 전체 이벤트 속성정보가 JSON으로 표시됩니다.
• 메시징 기록: 최근 30일간 해당 사용자의 메시징 관련 최근 이벤트.
• 기능 플래그 자격: 롤아웃, 캔버스 단계, 실험 전반에서 사용자가 현재 자격이 있는 기능 플래그를 확인합니다.

• 개요 탭
• 인게이지먼트 탭
• 이벤트 기록 탭

수신한 Campaigns에 표시되는 시점

일반적으로 Braze는 메시지 발송을 시도한 후 수신한 Campaigns에 해당 Campaign을 표시합니다. 발송이 기록되기 위해 사용자의 기기나 받은편지함에 실제로 전달될 필요는 없습니다. 수신한 Canvas 메시지도 각 Canvas 메시지 유형에 대해 동일한 채널별 규칙을 따릅니다.

• 이메일: Braze는 메시지가 이메일 서비스 공급자(ESP)에 전달될 때 발송을 기록합니다. 전달 이후에는 Liquid 로직, 사용량 제한, 또는 사용자가 도달 불가로 표시되어 메시지가 중단되지 않습니다. 이후 이벤트는 보통 전달 또는 반송입니다.
• 푸시: Braze는 메시지가 푸시 제공업체(예: Apple Push Notification service(APNs) 또는 Firebase Cloud Messaging(FCM))에 전달될 때 발송을 기록합니다. 제공업체는 보통 즉시 전달을 시도하며, 기기를 사용할 수 없는 경우(예: 오프라인) 메시지가 만료될 때까지 재시도할 수 있습니다.
• 인앱 메시지: Braze는 Campaign이 시작될 때 발송을 기록합니다.
• Content Cards: Braze가 발송 이벤트를 기록하는 시점은 전달 유형과 카드 생성 설정에 따라 달라집니다. 콘텐츠 카드 Campaign은 사용자가 앱에서 카드를 조회한 후에만 고객 프로필의 수신한 Campaigns에 표시됩니다. 전체 분류는 Content Cards 리포팅 문서의 발송이 기록되는 시점 및 수신한 Campaigns 및 리타겟팅 필터를 참조하세요.
• SMS, WhatsApp, 웹훅: Braze는 메시지가 해당 채널의 전달 경로(예: SMS 또는 WhatsApp 제공업체, 또는 웹훅 엔드포인트)에 진입할 때 발송을 기록합니다.

메시징 기록 탭

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

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

이벤트 보기 및 이해

메시징 기록 테이블의 각 이벤트에 대해 메시징 채널, 이벤트 유형, 이벤트 발생 타임스탬프, 관련 Campaign 또는 Canvas 메시지, 사용자의 기기 데이터를 확인할 수 있습니다. 특정 이벤트를 필터링하려면 필터를 클릭하고 목록에서 이벤트를 선택합니다.

메시지 인게이지먼트 이벤트

다음 메시지 인게이지먼트 이벤트는 이메일, SMS, 푸시, 인앱 메시지, Content Cards, 웹훅에서 사용할 수 있습니다. 특정 이벤트가 추적되는 방식에 대한 자세한 내용은 메시지 인게이지먼트 이벤트 용어집을 참조하세요.

채널	사용 가능한 인게이지먼트 이벤트
이메일	반송 클릭 지연 이벤트 전달 스팸 신고 열람 (이메일 열람 이벤트에 대한 참고 사항 참조) 발송 소프트 반송 탈퇴
SMS	통신사 발송 전달 전달 실패 인바운드 수신 거부 발송
푸시	반송 영향받은 열람 iOS 포그라운드 열람 발송
인앱 메시지	클릭 노출
Content Cards	클릭 닫기 노출 발송
웹훅	발송
WhatsApp	중단 전달 실패 최대 게재빈도 제한 인바운드 수신 읽음 발송

메시지 중단 이벤트

메시지 중단 이벤트는 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는 기록되지 않습니다.
• 사용자가 시드 그룹이나 기타 내부 테스트 오디언스에 속한 경우, 메시징 기록에 프로덕션 발송에 비해 제한된 Campaign 또는 Canvas 메타데이터가 표시될 수 있습니다.

데이터 크기 제약 조건

Braze는 사용자 프로필의 전체 크기에 대한 총 용량 제한을 적용하지 않습니다. 그러나 사용자와 관련된 특정 데이터 유형에는 정의된 크기 용량이 있습니다.

커스텀 속성 배열

커스텀 속성 배열(객체 배열 포함)의 용량은 100KB입니다. 이 용량을 초과하는 배열을 전송하면 커스텀 속성이 처리되지 않습니다. API는 성공 응답(201)을 반환하지만, 배열이 고객 프로필에 표시되지 않으며 해당 속성의 기존 데이터도 업데이트되지 않습니다.

배열이 이 용량에 근접하는 경우, 전체 크기가 100KB 이내로 유지되도록 채우는 객체 수를 제한하는 것을 고려하세요.

커스텀 속성에 대한 자세한 내용은 커스텀 속성 데이터 유형을 참조하세요.

관련 문서

• 사용자 프로필 수명주기
• POST: 식별자로 고객 프로필 내보내기
• POST: 사용자 삭제