메시징 옵저버빌리티

메시징 옵저버빌리티는 Canvas 또는 Campaign 전반에서 이벤트를 추적하여 메시징을 감사하고 문제를 해결할 수 있도록 합니다. 이를 사용하여 추세를 파악하고, 사용자가 Canvas를 통해 어떻게 진행되는지 확인하며, 메시지가 예상대로 전송되지 않은 이유를 진단할 수 있습니다.

주요 개념

전송됨 및 전달됨

이 대시보드는 Braze가 내부적으로 메시지를 처리한 방식을 보고하며, 메시지의 최종 전달 상태를 나타내는 것은 아닙니다.

이 대시보드에서 “전송됨”으로 표시된 메시지는 Braze가 해당 메시지를 성공적으로 처리하고 발송했음을 의미합니다. 대부분의 채널에서 이는 Braze가 관련 서드파티 전송 파트너에게 메시지를 전달했음을 뜻합니다. 그러나 사용자의 기기로 최종 전달되었음을 보장하지는 않습니다.

Braze가 메시지를 “전송”할 때, 최종 전달은 외부 서비스에 따라 달라질 수 있습니다. 각 채널별 예시는 다음과 같습니다.

채널	최종 전달 예시
Content Cards	카드가 전송되었으며 열람할 수 있는 상태입니다.
이메일	Braze가 이메일 서비스 공급자(ESP)에게 메시지를 전달합니다. 이후 ESP가 최종 전달을 담당합니다. 예를 들어, 이메일 주소가 유효하지 않거나 받은편지함이 가득 찬 경우 ESP가 “반송”을 보고할 수 있습니다.
In-App Messages	사용자가 메시지를 확인했으며 노출 횟수가 기록되었습니다.
LINE	전송 파트너에게 메시지가 성공적으로 전달되었습니다.
푸시	Braze가 적절한 푸시 알림 서비스(iOS의 경우 Apple Push Notification service, Android의 경우 Firebase Cloud Messaging 등)에 메시지를 전달합니다. 해당 서비스가 기기로의 최종 알림 전달을 담당합니다.
SMS/MMS/RCS	Braze가 SMS 게이트웨이(예: Twilio)에 메시지를 전달합니다. 해당 게이트웨이가 이동통신사로의 최종 전달을 담당합니다.
웹훅	웹훅 요청이 성공적으로 수행되어 2xx 응답을 반환했습니다.
WhatsApp	전송 파트너에게 메시지가 성공적으로 전달되었습니다.

Canvas 진행 이벤트

Canvases의 경우, 메시징 옵저버빌리티는 진행 이벤트도 표시합니다. 진행 이벤트란 Canvas 진입, 단계 진입, Canvas 이탈 등 사용자가 여정에서 이동하는 과정에 대한 기록입니다. 진행 이벤트는 메시지 전송 결과와는 별개입니다. 사용자가 Canvas의 어느 지점에 있는지 확인하는 데 도움이 됩니다.

데이터 최신성

이 대시보드의 데이터 업데이트 빈도는 시스템 부하에 따라 달라질 수 있습니다. 업데이트 빈도가 보장되지는 않지만, 대부분의 경우 1시간 미만일 가능성이 높습니다.

대시보드 구성

다음 중 하나의 위치에서 메시징 옵저버빌리티를 열 수 있습니다.

• Analytics > Dashboard Builder로 이동한 다음, Braze에서 생성한 대시보드 목록에서 Messaging Observability를 선택합니다.
• Canvas 또는 Campaign 분석 페이지에서 Messaging Observability를 선택합니다. 해당 Canvas 또는 Campaign이 사용 가능한 경우 미리 선택된 상태로 대시보드가 열립니다.

대시보드를 실행하고 데이터를 확인하려면 다음 단계를 수행합니다.

1. 최근 7일 이내의 날짜 또는 날짜 범위를 선택합니다.
2. 대시보드 보고서의 소스로 Campaigns 또는 Canvases를 선택합니다.
3. Campaign 또는 Canvas를 하나 선택합니다.
4. (선택 사항, Canvases만 해당) 하나 이상의 캔버스 단계를 선택하여 결과를 해당 단계로 좁힙니다.
5. Run dashboard를 선택하여 선택한 필터에 대한 데이터를 로드합니다.

데이터 해석하기

요약 타일

페이지 상단의 요약 타일에는 선택한 기간에 대해 다음 항목이 표시됩니다.

• Entries: 선택한 시간 범위 내에서 평가된 모든 적격 Canvas 또는 Campaign 항목입니다. 메시징 관측성은 다른 소스의 문제 해결 데이터를 사용하므로 분석 보기와 수치가 약간 다를 수 있습니다.
• Suppressions: 자격, 최대 게재빈도 설정, 방해금지 시간 등의 이유로 Braze가 항목 진입 후 의도적으로 보내지 않은 메시지입니다. 자세한 내용은 억제를 참조하세요.
• Failures: Liquid, 웹훅, 푸시 오류 등으로 인해 예기치 않게 실패한 메시지입니다. 자세한 내용은 실패를 참조하세요.
• Sent: Braze 처리를 성공적으로 완료한 메시지입니다. 수신자에게 전달이 보장되는 것은 아닙니다. 전달 여부는 채널, 통신사 및 기기에 따라 달라집니다. 자세한 내용은 전송 및 전달을 참조하세요.

시간별 이벤트

이 시계열 차트는 선택한 필터에 대한 이벤트의 시간별 분석을 보여줍니다. 차트 보기를 사용하여 개요 합계를 비교하거나 억제 및 실패를 성과별로 분류할 수 있습니다. 이 차트의 성과 라벨은 원시 이벤트 페이로드 값이 아닌 정규화된 대시보드 라벨입니다.

이벤트 로그

이벤트 로그는 선택한 필터와 시간 범위에 대해 Braze가 각 사용자에 대해 기록한 개별 이벤트(주로 억제, 진행, 실패)를 나열합니다. 타임스탬프, 사용자 ID, 캔버스 단계, 이벤트, 설명, 메시징 채널 등 특정 레코드를 검토하는 데 사용합니다.

특정 레코드에 집중하려면 테이블을 필터링하세요.

• Events 필터에서 이벤트 카테고리 또는 개별 이벤트를 선택합니다(예: Suppressions > Frequency capped 또는 Progressions > Entered step).
• 검색 필드에 사용자 ID를 입력하면 해당 사용자의 행이 표시됩니다.

두 필터를 모두 적용하면, 선택한 이벤트와 입력한 사용자 ID에 모두 일치하는 행이 테이블에 반환됩니다.

행에서 View를 선택하면 해당 이벤트에 대한 추가 컨텍스트가 포함된 사이드 패널이 열립니다. 패널에서 Ask Operator를 선택하여 해결 지침을 확인할 수도 있습니다.

진행 이벤트

진행 이벤트는 사용자가 Canvas를 통해 어떻게 이동하는지를 설명합니다. Canvas 전용입니다. Campaign 진입은 Entries 아래에 Entered campaign으로 표시됩니다.

진행 이벤트	설명
Canvas 진입	사용자가 Canvas에 진입했습니다. 진입은 스케줄 기반, 행동 기반 또는 API 트리거 방식일 수 있습니다. 대조군에 등록된 사용자도 이 라벨 아래에 표시될 수 있습니다.
행동 경로 단계 진입	사용자가 행동 경로 단계에 진입하여 행동(또는 기타 경로) 후 경로를 선택했습니다.
Agent 단계 진입	사용자가 Agent 단계에 진입하여 컨텍스트가 평가되었습니다.
오디언스 경로 단계 진입	사용자가 오디언스 경로 단계에 진입하여 오디언스 경로(또는 기타 경로)를 선택했습니다.
Audience Sync 단계 진입	사용자가 Audience Sync 단계에 진입하여 오디언스 동기화가 시작되었습니다.
Content Optimizer 단계 진입	사용자가 Content Optimizer 단계에 진입하여 배리언트가 선택되었습니다.
Context 단계 진입	사용자가 Context 단계에 진입하여 컨텍스트 변수가 설정되거나 평가되었습니다.
결정 분할 단계 진입	사용자가 결정 분할 단계에 진입하여 브랜치를 선택했습니다.
Delay 단계 진입	사용자가 Delay 단계에 진입하여 지연 중이거나, 즉시 진행하거나(예: 제로 지연), 해당 단계를 통해 진행 중입니다.
실험 경로 단계 진입	사용자가 실험 경로 단계에 진입하여 실험 배리언트에 할당되었습니다.
Feature Flag 단계 진입	사용자가 Feature Flag 단계에 진입하여 기능 플래그가 평가되고 있습니다.
Message 단계 진입	사용자가 Message 단계에 진입했습니다. 해당 단계의 이후 억제, 실패 또는 전송은 별도 이벤트로 표시됩니다.
Send to Destination 단계 진입	사용자가 Send to Destination 단계에 진입했습니다. Braze가 대상 Canvas 진입 자격 여부를 확인하고 있습니다.
User Update 단계 진입	사용자가 User Update 단계에 진입했습니다. 사용자 속성이 업데이트되고 있거나 User Update 사용량 제한조치로 인해 사용자가 일시적으로 지연되고 있습니다.
대상으로 전송됨	사용자가 대상 Canvas로 전송되어 현재 Canvas의 다음 단계로 이동했습니다.
대상으로 전송되지 않음	사용자가 대상 Canvas에 진입하지 못했으며(예: 오디언스 불일치) 현재 Canvas의 다음 단계로 이동했습니다.
대상을 찾을 수 없음	대상 Canvas를 찾을 수 없었습니다. 사용자는 현재 Canvas의 다음 단계로 이동했습니다.
Canvas 종료	사용자가 Canvas를 떠났습니다. 다음과 같은 경우에 발생합니다. Canvas 종료 기준 을 충족한 경우 Canvas 또는 단계가 중지되었거나 단계가 삭제된 경우 계속 진행할 자격이 없거나 Canvas 경로가 누락된 경우 Delay 단계에서 개인화된 지연을 계산할 수 없거나 지연 시간이 이미 지난 경우 계속 진행할 수 없는 경우 행동 경로 단계에 평가 기간을 계산할 수 없거나 중복 행동을 수신한 경우 실험 경로 단계에서 분할을 적용할 수 없거나, 홀드아웃을 전송할 수 없거나, 대조군에 다음 단계가 없어 계속 진행할 수 없는 경우 단계의 재시도가 소진된 경우

억제

억제는 설정, 자격 또는 전달 제어에 의해 진입 후 의도적으로 전송되지 않은 것입니다.

전송 설정

억제	설명
우선순위로 인해 중단됨	이 사용자에 대해 더 높은 우선순위의 메시지가 이미 대기 중이었거나 이 메시지의 우선순위가 낮아져 전송이 중단되었습니다.
배너 만료됨	배너가 발송되기 전에 만료되었습니다.
콘텐츠 카드 만료됨	사용자가 보기 전에 콘텐츠 카드가 만료되었습니다.
Content Optimizer 배리언트 비활성화됨	전송 전에 Content Optimizer 배리언트 할당이 비활성화되었습니다.
최대 게재빈도 설정됨	사용자가 워크스페이스의 최대 게재빈도 설정 규칙에서 허용되는 최대 메시지 수를 이미 수신하여 전송이 취소되었습니다.
비활성 Campaign	메시지가 전송 중인 동안 Campaign이 중지되어 중단되었습니다.
비활성 Canvas	사용자가 여정에 진입하기 전에 Canvas가 중지되었습니다.
비활성 캔버스 단계	Canvas에서 다음과 같은 경우에 발생할 수 있습니다. 캔버스 단계가 삭제된 경우 Canvas가 중지되어 모든 단계가 비활성화된 경우
방해금지 시간 중단	Campaign 또는 캔버스 단계에 대체 옵션이 메시지 중단으로 설정된 상태에서 방해금지 시간이 활성화되어 있었습니다. 사용자가 방해금지 시간 중에 Campaign을 트리거하거나 Canvas Message 단계에 진입하여 메시지가 중단되었습니다. 단, Canvas에서 사용자가 종료되지는 않습니다.
볼륨 제한됨	Campaign 또는 Canvas가 설정된 볼륨 한도에 도달하여 전송이 취소되었습니다.

사용자 자격

억제	설명
중복 사용자 식별자	일치하는 식별자(예: 외부 ID, 이메일 주소 또는 전화번호)를 가진 여러 사용자가 이 메시지를 수신할 자격이 있었습니다. 동일 사용자에게 중복 전송을 방지하기 위해 이 메시지가 중단되었습니다.
예외 또는 종료 이벤트	사용자가 이전에 메시지를 수신할 자격이 있었지만, 행동 기반 Campaign에 대해 예외 이벤트 를 수행하여 메시지가 중단되었거나, Canvas 종료 기준 을 충족하여 여정 도중 이탈되었습니다.
Message 단계 사전 검사 실패	Braze는 Canvas Message 단계에 대한 전체 전달 검증 전에 오디언스 자격, 재자격 및 채널 자격에 대한 기본 사전 검사 세트를 실행합니다. 이 결과는 사용자 또는 메시지가 해당 검사 중 하나에 실패하여 해당 단계에서 메시지가 중단되었음을 의미합니다.
트리거된 메시지 사전 검사 실패	Braze는 이 트리거에서 전송할 메시지를 생성하기 전에 오디언스 자격, 재자격 및 채널 자격에 대한 기본 사전 검사 세트를 실행합니다. 이 결과는 사용자 또는 메시지가 해당 검사 중 하나에 실패하여 메시지가 중단되었음을 의미합니다.
사용자 더 이상 자격 없음	사용자가 처음에는 타겟 오디언스에 포함되어 있었지만, Braze가 메시지를 보내거나 사용자를 Canvas에 진입시키기 전에 더 이상 오디언스 기준과 일치하지 않게 되었습니다. 사용자가 처음 오디언스 기준을 충족한 시점과 오디언스에서 이탈한 시점 사이의 시간은 다음과 같은 지연으로 인해 발생할 수 있습니다. Intelligent Timing 방해금지 시간 현지 시간 전달 속도 사용량 제한(Canvas 진입에는 적용되지 않음) 메시징 파이프라인 지연
채널 자격 없음	사용자가 선택한 채널에서 이 메시지를 수신할 자격이 없습니다. 일반적인 이유로는 채널 식별자 누락 또는 유효하지 않음, 적격 푸시 토큰 없음, 구독 상태 제한, 지원되지 않는 채널 기능, 전화 기반 채널의 차단된 국가 등이 있습니다.
단계 자격 없음	사용자가 Message 단계에 대해 설정된 전달 검증 조건을 충족하지 못했거나 억제 목록에 포함되어 있었습니다. 전달 검증 설정에 따라 사용자가 Canvas에서 종료되거나 다음 단계로 진행될 수 있습니다.
재자격 없음	사용자가 메시지를 수신하거나 Canvas에 진입할 자격이 있었지만, 재자격 또는 재진입 설정으로 인해 전송이 취소되었습니다. 사용자가 이미 최근에 Campaign을 수신했거나 Canvas에 진입했거나, 동일 Campaign에 대한 다른 전송이 이미 이 사용자에 대해 진행 중이거나, 재자격 또는 재진입이 꺼져 있는 경우 발생할 수 있습니다.

실패

실패는 처리 또는 전달 시도 중 발생한 예기치 않은 오류입니다.

실패	설명
연결된 콘텐츠 실패	Braze가 메시지를 전송하려 했으나, 연결된 콘텐츠가 최대 재시도 횟수(기본값 5회) 이후에 실패했습니다. 이 수치는 실패한 연결된 콘텐츠 요청의 총 수가 아니라 최대 재시도 횟수에 도달하여 중단된 메시지 수를 나타냅니다.
콘텐츠 카드 유효하지 않음	콘텐츠 카드에 오류가 있어 사용자에게 전송되지 않았습니다. 일반적인 원인은 다음과 같습니다. 최대 크기 초과(2 KB) 만료일이 유효하지 않음 메시지에 유효하지 않은 문자가 포함됨
Delay 단계 실패	Delay 단계가 실패하여 사용자가 Canvas에서 종료되었습니다. 이 실패는 다음과 같은 경우에 발생할 수 있습니다. 개인화된 지연 단계에 제공된 변수가 비어 있거나 유효하지 않은 유형인 경우 지연이 Canvas 내에서 허용된 최대 기간을 초과한 경우
Liquid 중단	abort_message Liquid 태그가 호출되어 전송이 취소되었습니다.
Liquid 렌더링 시간 초과	Liquid 템플릿 렌더링에 너무 오래 걸렸습니다. 배너, 인앱 메시지 및 이메일에서 가장 많이 발생합니다.
Liquid 구문 오류	Liquid 템플릿에 파싱 오류가 있어 메시지가 취소되었습니다.
미디어 URL 실패	Braze가 메시지의 미디어 URL을 처리할 수 없었습니다. URL이 차단되었거나, 유효하지 않거나, 시간이 초과되었거나, 유효하지 않은 HTTP 상태를 반환했거나, SSL 검증에 실패한 경우 발생할 수 있습니다.
파트너 전달 오류	Braze가 24시간 동안 전달 파트너에게 이 메시지를 전송하려 했으나, 파트너가 전체 기간 동안 일시적 오류를 반환했습니다.
제품 추천 유효하지 않음	이 전송에 제품 추천 또는 카탈로그 선택을 사용할 수 없었습니다. 일반적인 원인에는 추천이 누락되었거나 보관되었거나, 교육이 완료되지 않았거나, 필터가 모든 카탈로그 항목을 제거한 경우가 포함됩니다.
푸시 자격 증명 유효하지 않음	이 앱의 푸시 자격 증명이 누락되었거나 유효하지 않아 전송이 취소되었습니다. App Settings에서 자격 증명을 업데이트하세요.
72시간 이상 사용량 제한됨	전달 속도 사용량 제한으로 인해 메시지가 72시간 이상 제한되어 전송이 중단되었습니다.
구독 그룹 실패	구독 그룹 또는 메시징 서비스 구성 문제로 메시지를 전송할 수 없었습니다. 일반적인 원인에는 SMS 또는 WhatsApp의 전송 번호 누락, 또는 구성된 메시징 서비스에서 MMS가 지원되지 않는 경우가 포함됩니다.
고객 프로필을 찾을 수 없음	사용자가 존재한 적이 없거나 Braze에 더 이상 존재하지 않습니다. 일반적인 경우는 다음과 같습니다. API 메시징을 사용하여 타겟팅했지만 Braze에 존재한 적이 없는 사용자인 경우 메시지가 전송되거나 캔버스 단계가 실행되기 전에 사용자가 삭제된 경우 메시지가 전송되기 전에 사용자가 다른 프로필과 병합된 경우
웹훅 실패	웹훅이 실패 응답 코드(비2xx)를 수신했습니다. 일반적인 오류 코드에는 4XX 클라이언트 오류, 5XX 서버 오류 또는 시간 초과, 598 Host Unhealthy 또는 요청이 일시적으로 중단된 경우가 포함될 수 있습니다.
기타	이 테이블의 다른 카테고리에 해당하지 않는 실패입니다. 기타 실패가 큰 비율을 차지하는 경우, 추가 지원을 위해 Braze 지원팀에 문의하세요.

자주 묻는 질문

“사전 검사” 실패란 무엇인가요?

“사전 검사”란 파이프라인 단계의 맨 처음(예: 메시지 트리거 또는 Canvas 메시지 단계 전송 시)에 실행되는 고속 번들 유효성 검사를 의미합니다. 최대 속도를 위해 설계된 조기 종료라고 생각하면 됩니다. 사용자 프로필의 모든 세부 사항을 검증하는 것처럼 여러 개의 개별적이고 리소스 집약적인 검사를 실행하는 대신, Braze는 여러 기본 유효성 검사를 하나의 “1차 통과”로 묶어 처리합니다.

사용자가 이 단일 번들 검사에 실패하면 즉시 제외됩니다. 이러한 번들 방식을 통해 Braze는 대량의 메시지를 고속으로 처리할 수 있으며, 각 메시지의 처리 지연 시간을 줄여 Campaigns 및 Canvases의 성능을 더 빠르고 안정적으로 유지하는 데 기여할 수 있습니다.

“기타” 실패란 무엇인가요?

기존 대시보드 카테고리에 해당하지 않는 실패입니다. 기타 실패가 큰 비중을 차지하는 경우 Braze 지원팀에 문의하여 추가 지원을 받으세요.

항목, 억제, 실패, 전송을 합산해도 예상 오디언스 규모와 일치하지 않는 이유는 무엇인가요?

이런 상황은 다음과 같은 여러 가지 이유로 발생할 수 있습니다.

• 오디언스 기준: Campaign 또는 Canvas가 시작되었을 때, 예상보다 적은 수의 사용자가 오디언스 기준을 충족했을 수 있습니다(예: Segment에 속하지 않았거나 필요한 속성이 없었던 경우).
• 처리 진행 중: 메시지 또는 캔버스 단계가 아직 활발하게 처리 중일 수 있습니다. 사용자가 Canvas의 이전 단계에 아직 머물러 있어 메시지 단계에 도달하지 못했을 수 있습니다.
• 전송 없는 진행: 사용자는 같은 기간 내에 억제, 실패 또는 전송에 해당하지 않으면서도 진행 이벤트(예: 지연 또는 결정 분할 단계 진입)를 생성할 수 있습니다.
• 데이터 최신성: 대시보드 데이터는 약 15분마다 업데이트되지만 보장되지는 않습니다. 해당 Campaign 또는 Canvas의 최신 데이터가 아직 대시보드에 반영되지 않았을 수 있습니다.
• 엣지 케이스: 현재 이 대시보드에서 포착되지 않는 엣지 케이스를 겪고 있을 가능성이 적지만 있습니다. 이런 경우가 의심된다면 Braze 지원팀에 문의하세요.

타일 또는 이벤트 로그 합계가 Campaign 또는 Canvas의 오디언스보다 클 수 있는 이유는 무엇인가요?

이런 상황은 다음과 같은 이유로 발생할 수 있습니다.

• 멀티채널 메시지: Campaign 또는 캔버스 단계가 여러 채널(예: 단문 메시지 서비스 및 이메일)로 전송하도록 구성되어 있는 경우입니다. 한 사용자가 특정 채널(예: 이메일)에서는 “전송됨” 결과를 받으면서, 다른 채널(예: “사용자가 해당 채널에 적합하지 않음”)에서는 억제 또는 실패가 발생할 수 있습니다. 이 경우 해당 사용자는 타일 및 이벤트 로그에서 두 번 이상 카운트됩니다.
  • 예를 들어 iOS와 Android를 모두 타겟팅하여 100명의 사용자에게 푸시 Campaign을 전송한다고 가정합니다. 한 사용자가 iOS 기기만 보유한 경우, iOS 푸시(“전송됨”)는 수신하지만 Android 푸시에 대해서는 억제(“사용자가 해당 채널에 적합하지 않음”)가 트리거됩니다.
• 복수 메시지 단계(Canvas 전용): Canvas의 특정 경로에 하나 이상의 메시지 단계가 있을 수 있습니다. 이 대시보드는 모든 이벤트를 집계하므로, 선택한 기간 내에 여러 단계를 통과하는 경우 단일 사용자가 여러 번 카운트될 수 있습니다.
• 테스트 메시지: 테스트 전송(대시보드에서 카운트됨)으로 인해 합계가 오디언스 규모보다 높아질 수 있습니다.