메시징 옵저버빌리티
메시징 옵저버빌리티는 Canvas 또는 Campaign 전반에서 이벤트를 추적하여 메시징을 감사하고 문제를 해결할 수 있도록 합니다. 이를 사용하여 추세를 파악하고, 사용자가 Canvas를 통해 어떻게 진행하는지 확인하며, 메시지가 예상대로 전송되지 않았을 수 있는 이유를 진단할 수 있습니다.
사전 요구 사항
메시징 옵저버빌리티(Messaging Observability)에 액세스하려면 워크스페이스에 대한 “View Dashboard Reports” 권한이 있어야 합니다.
주요 개념
전송 및 전달
이 대시보드는 메시지의 최종 전달 상태가 아니라 Braze가 내부적으로 메시지를 어떻게 처리했는지를 보고합니다.
이 대시보드에서 “전송됨”으로 표시된 메시지는 Braze가 메시지를 성공적으로 처리하고 발송했다는 의미입니다. 대부분의 채널에서는 Braze가 해당 서드파티 발송 파트너에게 메시지를 넘겼다는 뜻입니다. 하지만 사용자 기기까지 최종 전달되었음을 보장하지는 않습니다.
Braze가 메시지를 “전송”한 뒤 최종 전달 여부는 외부 서비스에 따라 달라질 수 있습니다. 채널별 예시는 다음과 같습니다.
| 채널 | 최종 전달 예시 |
|---|---|
| 배너 | 배너가 전송되어 조회할 수 있는 상태입니다. |
| Content Cards | 카드가 전송되어 조회할 수 있는 상태입니다. |
| 이메일 | Braze가 메시지를 이메일 서비스 공급자(ESP)에 넘깁니다. 이후 최종 전달은 ESP가 담당합니다. 예를 들어 이메일 주소가 유효하지 않거나 받은편지함이 가득 찬 경우 해당 ESP가 “반송”을 보고할 수 있습니다. |
| 인앱 메시지 | 사용자가 메시지를 조회했고 노출 횟수가 기록되었습니다. |
| KakaoTalk | 메시지가 발송 파트너에게 성공적으로 전달되었습니다. |
| LINE | 메시지가 발송 파트너에게 성공적으로 전달되었습니다. |
| 푸시 | Braze가 메시지를 적절한 푸시 알림 서비스(예: iOS의 Apple Push Notification service, Android의 Firebase Cloud Messaging)에 넘깁니다. 기기로의 알림 최종 전달은 해당 서비스가 담당합니다. |
| SMS/MMS/RCS | Braze가 메시지를 SMS 게이트웨이(예: Twilio)에 넘깁니다. 이동통신사로의 최종 전달은 해당 게이트웨이가 담당합니다. |
| 웹훅 | 웹훅 요청이 성공적으로 이루어져 2xx 응답을 반환했습니다. |
| 메시지가 발송 파트너에게 성공적으로 전달되었습니다. |
Canvas 진행 이벤트
Canvas의 경우 Messaging Observability는 진행 이벤트도 보여줍니다. 진행 이벤트는 Canvas 진입, 단계 진입, Canvas 종료처럼 사용자가 여정을 어떻게 이동하는지를 기록한 것입니다. 진행 이벤트는 메시지 전송 결과와는 별개이며, 사용자가 Canvas의 어느 위치에 있는지 파악하는 데 도움이 됩니다.
데이터 최신성
이 대시보드의 데이터 업데이트 빈도는 시스템 부하에 따라 달라질 수 있습니다. 업데이트 빈도가 보장되지는 않지만, 대부분의 경우 1시간 이내에 업데이트됩니다.
대시보드 구성
다음 위치 중 한 곳에서 메시징 관찰 가능성을 열 수 있습니다.
- 분석 > 대시보드 빌더로 이동한 다음, Braze에서 생성한 대시보드 목록에서 메시징 관찰 가능성을 선택합니다.
- Canvas 또는 캠페인 분석 페이지에서 메시징 관찰 가능성을 선택합니다. 가능한 경우 해당 Canvas 또는 캠페인이 미리 선택된 상태로 대시보드가 열립니다.
대시보드를 실행하고 데이터를 확인하려면 다음 단계를 따르세요.
- 최근 7일 이내의 날짜 또는 기간을 선택합니다.
- 대시보드 보고서의 소스로 Campaigns 또는 Canvases 중 하나를 선택합니다.
- 캠페인 또는 Canvas를 하나 선택합니다.
- (선택 사항, Canvases만 해당) 하나 이상의 캔버스 단계를 선택하여 결과를 해당 단계로 좁힙니다.
- 대시보드 실행을 선택하여 선택한 필터에 대한 데이터를 로드합니다.

필터를 변경한 후에는 대시보드 실행을 다시 선택하여 요약 타일, 차트, 이벤트 로그를 새로 고치세요. 새로 고치기 전까지 대시보드에 “오래된 결과” 경고가 표시될 수 있습니다.

데이터 해석하기

대시보드에는 최대 지난 7일간의 데이터가 표시됩니다. 모든 타임스탬프는 워크스페이스의 시간대로 표시됩니다.
요약 타일
페이지 상단에는 선택한 기간에 대한 요약 타일이 다음과 같이 표시됩니다.
- Entries: 선택한 시간 범위 동안 평가된 모든 적격 Canvas 또는 Campaign 항목입니다. Messaging Observability는 서로 다른 소스의 문제 해결 데이터를 사용하므로, 이 수치는 분석 보기와 약간 다를 수 있습니다.
- Suppressions: 자격 요건, 최대 게재빈도 설정, 방해금지 시간 등의 이유로 Braze가 진입 후 의도적으로 발송하지 않은 메시지입니다. 자세한 내용은 Suppressions를 참조하세요.
- Failures: Liquid, 웹훅, 푸시 오류 등으로 예기치 않게 실패한 메시지입니다. 자세한 내용은 Failures를 참조하세요.
- Sent: Braze 처리 과정을 성공적으로 벗어난 메시지입니다. 이것이 수신자에게 전달되었음을 보장하지는 않습니다. 전달 여부는 채널, 통신사, 기기에 따라 달라집니다. 자세한 내용은 Sent and delivered를 참조하세요.
시간 경과에 따른 이벤트
이 시계열 차트는 선택한 필터에 대한 이벤트를 시간별로 분류하여 보여줍니다. 차트 보기를 사용하여 개요 합계를 비교하거나, 성과별로 Suppressions와 Failures를 세분화할 수 있습니다. 이 차트의 성과 레이블은 원시 이벤트 페이로드 값이 아닌, 정규화된 대시보드 레이블입니다.
이벤트 로그
Event log에는 선택한 필터와 시간 범위에 대해 Braze가 각 사용자별로 기록한 개별 이벤트가 나열되며, 주로 Suppressions, Progressions, Failures가 포함됩니다. 이를 사용하여 타임스탬프, 사용자 ID, 캔버스 단계, 이벤트, 설명, 메시징 채널 등 특정 레코드를 검토할 수 있습니다.

테이블을 필터링하여 특정 레코드에 집중할 수 있습니다.
- Events 필터에서 이벤트 카테고리 또는 개별 이벤트를 선택합니다(예: Suppressions > Frequency capped 또는 Progressions > Entered step).
- 검색 필드에 사용자 ID를 입력하면 해당 사용자의 행이 표시됩니다.
두 필터를 모두 적용하면 선택한 이벤트와 입력한 사용자 ID에 모두 일치하는 행이 테이블에 반환됩니다.
행에서 View를 선택하면 해당 이벤트에 대한 추가 컨텍스트가 담긴 사이드 패널이 열립니다. 패널에서 Ask Operator를 선택하여 해결 방법에 대한 안내를 받을 수도 있습니다.

채널 필터는 특정 메시징 채널과 연결된 이벤트에 적용됩니다. 일부 이벤트는 채널과 무관하므로, 채널 필터를 적용해도 집계 보기에 계속 표시될 수 있습니다.
진행 이벤트
진행 이벤트는 사용자가 Canvas를 통해 어떻게 이동하는지 설명합니다. 이 이벤트는 Canvas에만 해당합니다. Campaign 진입은 Entries 아래에 Entered campaign으로 표시됩니다.

Messaging Observability의 진행 이벤트 레이블은 사람이 읽을 수 있는 대시보드 레이블입니다. 이러한 데이터 세트는 표현 방식과 처리 경로가 서로 다르므로, 수치나 명칭이 다른 Braze 분석 화면과 다를 수 있습니다.
| 진행 이벤트 | 설명 |
|---|---|
| Entered Canvas | 사용자가 Canvas에 진입했습니다. 진입은 예약, 실행 기반 또는 API 트리거 방식일 수 있습니다. 대조군에 등록된 사용자도 이 레이블 아래에 표시될 수 있습니다. |
| Entered Action Path step | 사용자가 작업 경로 단계에 진입하여 행동 이후의 경로(또는 다른 모든 사용자 경로)를 따랐습니다. |
| Entered Agent step | 사용자가 컨텍스트가 평가되는 에이전트 단계에 진입했습니다. |
| Entered Audience Path step | 사용자가 오디언스 경로 단계에 진입하여 오디언스 경로(또는 다른 모든 사용자 경로)를 따랐습니다. |
| Entered Audience Sync step | 사용자가 오디언스 동기화 단계에 진입하여 오디언스 동기화가 시작되었습니다. |
| Entered Content Optimizer step | 사용자가 콘텐츠 최적화 도구 단계에 진입하여 배리언트가 선택되었습니다. |
| Entered Context step | 사용자가 컨텍스트 변수가 설정되거나 평가되는 컨텍스트 단계에 진입했습니다. |
| Entered Decision Split step | 사용자가 결정 분할 단계에 진입하여 브랜치를 따랐습니다. |
| Entered Delay step | 사용자가 지연 단계에 진입하여 지연 중이거나, 즉시 진행 중이거나(예: 지연 시간 0), 그 밖의 방식으로 해당 단계를 진행 중입니다. |
| Entered Experiment Path step | 사용자가 실험 경로 단계에 진입하여 실험 배리언트에 할당되었습니다. |
| Entered Feature Flag step | 사용자가 기능 플래그 단계에 진입하여 기능 플래그가 평가되고 있습니다. |
| Entered Message step | 사용자가 메시지 단계에 진입했습니다. 이후 해당 단계에 대한 Suppressions, Failures 또는 발송은 별도의 이벤트로 표시됩니다. |
| Entered Send to Destination step | 사용자가 대상으로 보내기 단계에 진입했습니다. Braze가 사용자가 대상 Canvas에 진입할 자격이 있는지 확인하고 있습니다. |
| Entered User Update step | 사용자가 사용자 업데이트 단계에 진입했습니다. 사용자 속성이 업데이트되고 있거나, 사용자 업데이트 사용량 제한조치로 인해 사용자가 일시적으로 지연되고 있습니다. |
| Sent to destination | 사용자가 대상 Canvas로 보내졌으며, 현재 Canvas의 다음 단계로 이동했습니다. |
| Not sent to destination | 사용자가 대상 Canvas에 진입하지 않았으며(예: 오디언스 불일치로 인해), 현재 Canvas의 다음 단계로 이동했습니다. |
| Destination not found | 대상 Canvas를 찾을 수 없었습니다. 사용자는 현재 Canvas의 다음 단계로 이동했습니다. |
| Exited Canvas | 사용자가 Canvas를 떠났습니다. 이는 다음과 같은 경우에 발생합니다.
|
Suppressions
Suppressions는 설정, 자격 요건 또는 전달 제어에 따라 진입 후 의도적으로 발송하지 않은 경우입니다.

Messaging Observability의 Suppressions 및 Failures 레이블은 사람이 읽을 수 있는 대시보드 레이블입니다. Currents 메시지 인게이지먼트 이벤트에서는 중단 정보가 abort_type 및 abort_log와 같은 필드로 표현됩니다. 이러한 데이터 세트는 표현 방식과 처리 경로가 서로 다르므로, Currents와 Messaging Observability 간에 수치나 명칭이 다를 수 있습니다.
발송 설정
| Suppression | 설명 |
|---|---|
| Aborted due to priority | 이 사용자에 대해 우선순위가 더 높은 다른 메시지가 이미 대기 중이었거나, 이 메시지의 우선순위가 낮아져 발송이 중단되었습니다. |
| Banner expired | 배너가 발송되기 전에 만료되었습니다. |
| Content Card expired | 사용자가 확인하기 전에 콘텐츠 카드가 만료되었습니다. |
| Content Optimizer variant deactivated | 발송 전에 콘텐츠 최적화 도구 배리언트 할당이 비활성화되었습니다. |
| Frequency capped | 사용자가 워크스페이스의 최대 게재빈도 설정 규칙에 따라 허용되는 최대 메시지 수를 이미 수신하여 발송이 취소되었습니다. |
| Inactive campaign | 메시지가 처리 중인 동안 Campaign이 중지되어 메시지가 중단되었습니다. |
| Inactive Canvas | 사용자가 여정에 진입하기 전에 Canvas가 중지되었습니다. |
| Inactive Canvas step | Canvas에서 다음과 같은 경우에 발생할 수 있습니다.
|
| Quiet Hours abort | Campaign 또는 캔버스 단계에 방해금지 시간이 활성화되어 있고 대체 설정이 Abort message로 지정되어 있습니다. 사용자가 방해금지 시간 동안 Campaign을 트리거하거나 Canvas 메시지 단계에 진입하여 메시지가 중단되었습니다. 단, 이로 인해 사용자가 Canvas에서 종료되지는 않습니다. |
| Volume limited | Campaign 또는 Canvas가 설정된 볼륨 한도에 도달하여 발송이 취소되었습니다. |
사용자 자격 요건
| Suppression | 설명 |
|---|---|
| Duplicate user identifier | 일치하는 식별자(예: 외부 ID, 이메일 주소, 전화번호)를 가진 여러 사용자가 이 메시지를 수신할 자격이 있었습니다. 동일한 사용자에게 중복 발송되는 것을 방지하기 위해 이 메시지가 중단되었습니다. |
| Exception or exit event | 사용자가 이전에는 메시지를 수신할 자격이 있었지만, 다음 중 하나에 해당합니다. |
| User failed pre-check for Message step | Braze는 Canvas 메시지 단계에 대한 전체 전달 검증 전에 오디언스 자격, 재자격, 채널 자격에 대한 기본 사전 확인을 1차로 실행합니다. 이 성과는 사용자 또는 메시지가 이러한 확인 중 하나를 통과하지 못해 해당 단계의 메시지가 중단되었음을 의미합니다. |
| User failed pre-check for triggered message | Braze는 이 트리거에서 발송할 메시지를 생성하기 전에 오디언스 자격, 재자격, 채널 자격에 대한 기본 사전 확인을 1차로 실행합니다. 이 성과는 사용자 또는 메시지가 이러한 확인 중 하나를 통과하지 못해 메시지가 중단되었음을 의미합니다. |
| User no longer eligible | 사용자가 처음에는 타겟 오디언스에 속했지만, Braze가 메시지를 발송하거나 사용자를 Canvas에 진입시키기 전에 더 이상 오디언스 기준을 충족하지 않았습니다. 사용자가 처음 오디언스 기준을 충족한 시점과 오디언스에서 제외된 시점 사이의 시간 차이는 다음으로 인한 지연 때문일 수 있습니다.
|
| User not eligible for channel | 사용자가 선택한 채널에서 이 메시지를 수신할 자격이 없습니다. 일반적인 원인으로는 채널 식별자 누락 또는 유효하지 않음, 적격 푸시 토큰 없음, 구독 상태 제한, 지원되지 않는 채널 기능, 전화 기반 채널의 차단된 국가 등이 있습니다. |
| User not eligible for step | 사용자가 메시지 단계에 설정된 전달 검증을 충족하지 못했거나 억제 목록에 포함되어 있었습니다. Delivery validations 설정에 따라 사용자가 Canvas에서 종료되었거나 다음 단계로 진행되었을 수 있습니다. |
| User not re-eligible | 사용자가 메시지를 수신하거나 Canvas에 진입할 자격이 있었지만, 재자격 또는 재진입 설정으로 인해 발송이 취소되었습니다. 이는 사용자가 이미 너무 최근에 Campaign을 수신했거나 Canvas에 진입한 경우, 동일한 Campaign의 다른 발송이 이 사용자에 대해 이미 진행 중인 경우, 또는 재자격이나 재진입이 꺼져 있는 경우에 발생할 수 있습니다. |
Failures
Failures는 처리 또는 전달 시도 중에 발생한 예기치 않은 오류입니다.
| Failure | 설명 |
|---|---|
| Connected Content failed | Braze가 메시지 발송을 시도했지만, 최대 재시도 횟수(기본값은 5회) 이후에도 연결된 콘텐츠가 실패했습니다. 이 수치는 실패한 연결된 콘텐츠 요청의 총수가 아니라, 최대 재시도 횟수에 도달하여 중단된 메시지 수를 나타냅니다. |
| Content Card invalid | 콘텐츠 카드에 오류가 있어 사용자에게 발송되지 않았습니다. 일반적인 원인은 다음과 같습니다.
|
| Delay step failure | 지연 단계가 실패하여 사용자가 Canvas에서 종료되었습니다. 이 실패는 다음과 같은 경우에 발생할 수 있습니다.
|
| Liquid abort | abort_message Liquid 태그가 호출되어 발송이 취소되었습니다. |
| Liquid rendering timeout | Liquid 템플릿을 렌더링하는 데 너무 오랜 시간이 걸렸습니다. 배너, 인앱 메시지, 이메일에서 가장 발생하기 쉽습니다. |
| Liquid syntax error | Liquid 템플릿에 구문 분석 오류가 있어 메시지가 취소되었습니다. |
| Media URL failure | Braze가 메시지의 미디어 URL을 처리할 수 없었습니다. 이는 URL이 차단되었거나, 유효하지 않거나, 시간이 초과되었거나, 유효하지 않은 HTTP 상태를 반환하거나, SSL 검증에 실패한 경우에 발생할 수 있습니다. |
| Partner delivery error | Braze가 24시간 동안 이 메시지를 전달 파트너에게 보내려고 시도했지만, 파트너가 해당 기간 내내 일시적인 오류를 반환했습니다. |
| Product recommendation invalid | 이 발송에 제품 추천 또는 카탈로그 선택을 사용할 수 없었습니다. 일반적인 원인으로는 추천 누락 또는 보관, 교육 미완료, 모든 카탈로그 항목을 제거한 필터 등이 있습니다. |
| Push credentials invalid | 이 앱의 푸시 자격 증명이 누락되었거나 유효하지 않아 발송이 취소되었습니다. App Settings에서 자격 증명을 업데이트하세요. |
| Rate limited over 72 hours | 전달 속도 사용량 제한으로 인해 메시지가 72시간 넘게 제한되어 발송이 중단되었습니다. |
| Subscription group failure | 구독 그룹 또는 메시징 서비스 구성 문제로 인해 메시지를 발송할 수 없었습니다. 일반적인 원인으로는 SMS 또는 WhatsApp용 발신 번호 누락, 구성된 메시징 서비스에서 MMS 미지원 등이 있습니다. |
| User profile not found | 사용자가 Braze에 존재한 적이 없거나 더 이상 존재하지 않습니다. 일반적인 사례는 다음과 같습니다.
|
| Webhook failed | 웹훅이 실패 응답 코드(2xx 이외)를 수신했습니다. 일반적인 오류 코드로는 4XX 클라이언트 오류, 5XX 서버 오류 또는 시간 초과, 598 Host Unhealthy 또는 일시적으로 중단된 요청 등이 있습니다. |
| Other | 이 표의 다른 카테고리에 해당하지 않는 실패입니다. Other 실패의 비율이 높다면 Braze 지원팀에 문의하여 추가 지원을 받으세요. |
자주 묻는 질문
‘사전 확인’ 실패는 무엇을 의미하나요?
‘사전 확인’이란 파이프라인 단계(예: 메시지가 트리거되거나 Canvas 메시지 단계가 발송될 때)의 맨 처음에 실행되는 고속 일괄 유효성 검사를 말합니다. 최대 속도를 위해 설계된 조기 종료 장치라고 생각하면 됩니다. Braze는 여러 개의 개별적이고 리소스 집약적인 검사(예: 사용자 프로필의 모든 세부 정보 검증)를 각각 실행하는 대신, 여러 기본 유효성 검사를 하나의 ‘1차 검사’로 묶어 처리합니다.
사용자가 이 일괄 검사를 통과하지 못하면 즉시 제외됩니다. 이러한 일괄 처리 방식 덕분에 Braze는 대량의 메시지를 빠른 속도로 처리할 수 있으며, 메시지별 처리 지연 시간을 줄여 Campaigns와 Canvases의 성능을 더 빠르고 안정적으로 유지하는 데 도움이 됩니다.
‘기타’ 실패는 무엇을 의미하나요?
기존 대시보드 카테고리에 해당하지 않는 실패입니다. 기타 실패의 비율이 여전히 높다면 Braze 지원팀에 문의하여 추가 지원을 받으세요.
진입, 억제, 실패, 발송의 합계가 예상 오디언스 규모와 일치하지 않는 이유는 무엇인가요?
다음과 같은 여러 가지 이유로 발생할 수 있습니다.
- 오디언스 기준: Campaign 또는 Canvas를 출시할 때 예상보다 적은 수의 사용자가 오디언스 기준을 충족했을 수 있습니다(예: 해당 Segment에 속하지 않았거나 필요한 속성이 없는 경우).
- 처리 진행 중: 메시지 또는 캔버스 단계가 아직 처리 중일 수 있습니다. 사용자가 아직 Canvas의 앞 단계에 머물러 있어 메시지 단계에 도달하지 않았을 수 있습니다.
- 발송 없는 진행: 사용자는 같은 기간 내에 해당하는 억제, 실패 또는 발송 없이 진행 이벤트(예: 지연 단계 또는 결정 분할 단계 진입)를 생성할 수 있습니다.
- 데이터 최신성: 대시보드 데이터는 약 15분마다 업데이트되지만 이는 보장되지 않습니다. 이 Campaign 또는 Canvas의 최신 데이터가 아직 대시보드에 반영되지 않았을 수 있습니다.
- 예외 사례: 현재 이 대시보드에 반영되지 않는 예외 사례에 해당할 가능성이 낮게나마 있습니다. 이런 경우로 의심된다면 Braze 지원팀에 문의하세요.
타일 또는 이벤트 로그 합계가 Campaign 또는 Canvas의 오디언스보다 클 수 있는 이유는 무엇인가요?
다음과 같은 이유로 발생할 수 있습니다.
- 멀티채널 메시지: Campaign 또는 캔버스 단계가 여러 채널(예: SMS와 이메일)로 발송되도록 구성된 경우입니다. 한 사용자가 한 채널(예: 이메일)에서는 ‘발송’ 결과를 받고, 다른 채널에서는 억제 또는 실패(예: ‘사용자가 채널에 적합하지 않음’)를 받을 수 있습니다. 이 경우 해당 사용자 한 명이 타일과 이벤트 로그 전반에서 두 번 이상 집계됩니다.
- 예를 들어 iOS와 Android를 모두 타겟팅하는 푸시 Campaign을 사용자 100명에게 발송한다고 가정해 보겠습니다. 어떤 사용자가 iOS 기기만 가지고 있다면, 해당 사용자는 iOS 푸시를 받지만(‘발송’) Android 푸시에 대해서는 억제(‘사용자가 채널에 적합하지 않음’)도 함께 트리거합니다.
- 여러 메시지 단계(Canvas 전용): Canvas의 특정 경로에 메시지 단계가 두 개 이상 있을 수 있습니다. 이 대시보드는 모든 이벤트를 집계하므로, 사용자가 선택한 기간 내에 여러 단계를 거치면 한 사용자가 여러 번 집계될 수 있습니다.
- 테스트 메시지: 테스트 발송도 대시보드에 집계되므로 합계가 오디언스 규모보다 커질 수 있습니다.