메시징 옵저버빌리티

메시징 옵저버빌리티는 메시지 전송 결과에 대한 상위 수준의 분류를 제공하여 메시징 설정의 추세를 파악하고 잠재적 문제를 진단할 수 있도록 합니다. 이 대시보드를 통해 Campaigns 또는 Canvases에서 메시지가 예상대로 전송되지 않은 이유를 이해할 수 있습니다.

주요 개념

전송됨과 전달됨

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

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

Braze가 메시지를 “전송”한 후 최종 전달은 외부 서비스에 따라 달라질 수 있습니다. 각 채널에 대한 다음 예시를 참고하세요.

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

데이터 최신성

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

대시보드 구성

Analytics > Dashboard Builder로 이동한 후 Braze가 생성한 대시보드 목록에서 메시징 옵저버빌리티를 선택하여 접근할 수 있습니다.

대시보드를 실행하고 데이터를 확인하려면 다음을 수행하세요.

1. 대시보드 보고서의 소스로 Campaigns 또는 Canvases를 선택합니다.
2. 하나 이상의 Campaign 또는 Canvas를 선택합니다.
3. Run Dashboard를 선택하여 선택한 필터의 데이터를 로드합니다.

데이터 해석

요약 타일

페이지 상단에는 선택한 기간에 대한 주요 요약 타일이 표시됩니다.

• 전송됨: Braze가 성공적으로 처리하고 전송한 메시지의 총 수입니다.
  • 이메일, SMS/MMS/RCS, WhatsApp, LINE, 푸시: 메시지가 전송 파트너에게 성공적으로 전달되었습니다.
  • 웹훅: 웹훅 요청이 성공적으로 수행되어 2xx 응답을 반환했습니다.
  • Content Cards: 카드가 전송되었으며 조회 가능한 상태입니다.
  • In-App Messages: 사용자에게 메시지가 표시되었습니다.
• 미전송: 중단된 메시지의 총 수입니다. 여기에는 Canvas에 진입하지 않은 Canvas 오디언스 멤버, 단계 실패를 경험했거나 종료 이벤트를 수행하는 동안 종료 기준을 충족하여 Canvas에서 퇴출된 사용자가 포함됩니다.

시간별 메시지 결과

이 시계열 차트는 메시지가 중단된 이유 또는 사용자가 Canvas에서 제외된 이유를 시간별로 분류하여 보여줍니다. 이 차트의 결과 레이블은 정규화된 대시보드 레이블이며 원시 이벤트 페이로드 값이 아닙니다. 이 차트에는 전송 수가 표시되지 않습니다.

메시지 결과 상세 로그

대시보드에는 선택한 필터와 시간 범위에 대한 개별 메시지 결과의 상세 테이블이 표시됩니다. 이 테이블을 사용하여 타임스탬프, 사용자 ID, 캔버스 단계, 결과, 세부 정보, 채널 등 특정 레코드를 검토할 수 있습니다.

테이블을 필터링하여 특정 레코드에 집중할 수 있습니다.

• 결과별 필터링: 결과 필터에서 결과를 선택하면 해당 결과에 해당하는 행만 표시됩니다(예: Frequency capped 또는 User not eligible for channel).
• 사용자 ID로 검색: 검색 필드에 사용자 ID를 입력하면 해당 특정 사용자의 행을 표시합니다.

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

테이블에서 행을 선택하면 세부 정보 패널이 열립니다. 세부 정보 패널은 해당 결과에 대한 추가 맥락을 제공하며, Ask Operator는 기본 문제를 해결하는 데 도움이 되는 교정 가이드를 제공합니다.

중단 결과

다음은 대시보드에 표시되는 중단 결과에 대한 정의입니다. 결과는 조사 중인 결과를 더 쉽게 찾을 수 있도록 카테고리별로 그룹화되어 있습니다.

콘텐츠 및 렌더링

중단 결과	설명
Content Card 만료됨	사용자가 보기 전에 Content Card가 만료되었습니다.
Content Card 무효	Content Card에 오류가 있어 사용자에게 전송되지 않았습니다. 일반적인 원인은 다음과 같습니다. 최대 크기 초과(2 KB) 만료 날짜가 유효하지 않음 메시지에 유효하지 않은 문자가 포함됨
연결된 콘텐츠 실패	Braze가 메시지를 전송하려 했으나 최대 재시도 횟수(기본값 5회) 후 연결된 콘텐츠가 실패했습니다. 참고: 이 수치는 최대 재시도 횟수에 도달하여 중단된 메시지의 수를 나타내며, 실패한 연결된 콘텐츠 요청의 총 수는 아닙니다.
인앱 메시지 렌더링 타임아웃	여러 번 재시도한 후에도 Liquid를 렌더링할 수 없어 타임아웃이 발생했습니다.
Liquid 중단	abort_message Liquid 태그가 호출되어 전송이 취소되었습니다.
Liquid 렌더링 타임아웃	Liquid 템플릿을 렌더링하는 데 너무 오래 걸렸습니다. 배너, 인앱 메시지, 이메일에서 가장 발생하기 쉽습니다.
Liquid 구문 오류	Liquid 템플릿에 구문 분석 오류가 있어 메시지가 취소되었습니다.
미디어 URL 실패	Braze가 메시지의 미디어 URL을 처리할 수 없었습니다. URL이 차단되었거나, 유효하지 않거나, 타임아웃이 발생했거나, 유효하지 않은 HTTP 상태를 반환했거나, SSL 검증에 실패한 경우에 발생할 수 있습니다.

Campaign 및 Canvas 상태

중단 결과	설명
지연 단계 실패	지연 단계가 실패하여 사용자가 Canvas에서 퇴출되었습니다. 이 실패는 다음과 같은 경우에 발생할 수 있습니다. 개인화된 지연 단계에 제공된 변수가 비어 있거나 유효하지 않은 유형인 경우 지연이 Canvas 내에서 허용된 최대 기간을 초과한 경우
예외 이벤트 또는 종료 이벤트	사용자가 이전에 메시지 수신 대상이었으나 다음 중 하나에 해당합니다. 액션 기반 Campaign에 대한 예외 이벤트 를 수행하여 메시지가 중단되었거나, Canvas 종료 기준 을 충족하여 여정 도중에 제외되었습니다.
비활성 Campaign	Campaign이 메시지가 전송 중일 때 중지되어 중단되었습니다.
비활성 Canvas	사용자가 여정에 진입하기 전에 Canvas가 중지되었습니다.
비활성 캔버스 단계	Canvas에서 다음과 같은 경우에 발생할 수 있습니다. 캔버스 단계가 삭제된 경우 Canvas가 중지되어 모든 단계가 비활성 상태가 된 경우
볼륨 제한 도달	Campaign이 설정된 볼륨 제한에 도달하여 전송이 취소되었습니다.

사용량 제한조치 및 타이밍

중단 결과	설명
최대 게재빈도 설정 초과	사용자가 워크스페이스의 최대 게재빈도 설정 규칙에 따라 허용된 최대 메시지 수를 이미 수신하여 전송이 취소되었습니다.
방해금지 시간 중단	Campaign 또는 캔버스 단계에 대해 방해금지 시간이 활성화되어 있고 대체 설정이 메시지 중단으로 설정되어 있습니다. 사용자가 방해금지 시간 동안 Campaign을 트리거하거나 Canvas 메시지 단계에 진입하여 메시지가 중단되었습니다. 단, 이로 인해 사용자가 Canvas에서 퇴출되지는 않습니다.
72시간 초과 사용량 제한	전달 속도 사용량 제한으로 인해 메시지가 72시간 이상 제한되어 전송이 중단되었습니다.

사용자 자격 및 프로필

중단 결과	설명
중복 사용자 식별자	동일한 식별자(외부 ID, 이메일 주소, 전화번호 등)를 가진 여러 사용자가 이 메시지를 수신할 자격이 있었습니다. 동일한 사용자에게 중복 전송을 방지하기 위해 이 메시지가 중단되었습니다.
메시지 단계 사전 검사 실패	Braze는 Canvas 메시지 단계에 대한 전체 전달 검증 전에 오디언스 자격, 재자격, 채널 자격에 대한 기본 사전 검사를 수행합니다. 이 결과는 사용자 또는 메시지가 해당 검사 중 하나에 실패하여 해당 단계에서 메시지가 중단되었음을 의미합니다.
트리거된 메시지 사전 검사 실패	Braze는 이 트리거에서 전송할 메시지를 생성하기 전에 오디언스 자격, 재자격, 채널 자격에 대한 기본 사전 검사를 수행합니다. 이 결과는 사용자 또는 메시지가 해당 검사 중 하나에 실패하여 메시지가 중단되었음을 의미합니다.
사용자가 더 이상 자격 없음	사용자가 처음에 타겟 오디언스에 포함되었으나, Braze가 메시지를 전송하거나 사용자를 Canvas에 진입시키기 전에 오디언스 기준에 더 이상 부합하지 않게 되었습니다. 사용자가 처음 오디언스 기준을 충족한 시점과 오디언스에서 벗어난 시점 사이의 시간 차이는 다음과 같은 지연으로 인해 발생할 수 있습니다. Intelligent Timing 방해금지 시간 현지 시간 전달 속도 사용량 제한(Canvas 진입에는 적용되지 않음) 메시징 파이프라인 지연
단계에 대한 사용자 부적격	사용자가 메시지 단계에 대한 설정된 전달 검증을 충족하지 못했거나 억제 목록에 포함되어 있었습니다. 전달 검증 설정에 따라 사용자가 Canvas에서 퇴출되거나 다음 단계로 진행되었을 수 있습니다.
사용자 재자격 없음	사용자가 메시지를 수신하거나 Canvas에 진입할 자격이 있었으나, 재자격 또는 재진입 설정으로 인해 전송이 취소되었습니다. 이는 사용자가 이미 최근에 Campaign을 수신하거나 Canvas에 진입한 경우, 동일한 Campaign에 대한 다른 전송이 해당 사용자에 대해 이미 진행 중인 경우, 또는 재자격이나 재진입이 비활성화된 경우에 발생할 수 있습니다.
사용자 프로필을 찾을 수 없음	사용자가 존재하지 않거나 Braze에 더 이상 존재하지 않습니다. 일반적인 사례는 다음과 같습니다. API 메시징을 사용하여 사용자를 타겟팅했으나 Braze에 존재한 적이 없는 경우 메시지가 전송되거나 캔버스 단계가 실행되기 전에 사용자가 삭제된 경우 메시지가 전송되기 전에 사용자가 다른 프로필과 병합된 경우

채널 및 전달

중단 결과	설명
파트너 전달 오류	Braze가 24시간 동안 전달 파트너에게 이 메시지를 전송하려 했으나, 파트너가 전체 기간 동안 일시적 오류를 반환했습니다.
푸시 자격 증명 무효	이 앱의 푸시 자격 증명이 누락되었거나 유효하지 않아 전송이 취소되었습니다. 앱 설정에서 자격 증명을 업데이트하세요.
구독 그룹 실패	구독 그룹 또는 메시징 서비스 구성 문제로 인해 메시지를 전송할 수 없었습니다. 일반적인 원인으로는 SMS 또는 WhatsApp의 전송 번호 누락, 또는 구성된 메시징 서비스에서 MMS가 지원되지 않는 경우 등이 있습니다.
채널에 대한 사용자 부적격	사용자가 선택한 채널에서 이 메시지를 수신할 자격이 없습니다. 일반적인 원인으로는 채널 식별자 누락 또는 무효, 유효한 푸시 토큰 없음, 가입 상태 제한, 지원되지 않는 채널 기능, 또는 전화 기반 채널에서 차단된 국가 등이 있습니다.
웹훅 실패	웹훅이 실패 응답 코드(비-2xx)를 수신했습니다. 일반적인 오류 코드에는 4XX 클라이언트 오류, 5XX 서버 오류 또는 타임아웃, 598 Host Unhealthy 또는 요청이 일시적으로 중단된 경우가 있습니다.

자주 묻는 질문

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

“사전 검사”란 파이프라인 단계(예: 메시지 트리거 또는 Canvas 메시지 단계 전송) 시작 시점에 수행되는 고속 번들 검증 검사를 말합니다. 최대 속도를 위해 설계된 조기 퇴출로 생각하면 됩니다. 사용자 프로필의 모든 세부 사항을 검증하는 것과 같은 별도의 리소스 집약적 검사를 여러 번 수행하는 대신, Braze는 여러 기본 검증을 하나의 “첫 번째 패스”로 번들합니다.

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

“기타” 중단 결과는 무엇을 의미하나요?

기존 대시보드 카테고리에 해당하지 않는 중단입니다. “기타”가 차지하는 중단 비율이 여전히 높은 경우 Braze 지원팀에 문의하여 추가 지원을 받으세요.

미전송과 전송됨의 합계가 예상 오디언스 크기보다 낮은 이유는 무엇인가요?

여러 가지 이유로 발생할 수 있습니다.

• 오디언스 기준: Campaign 또는 Canvas가 실행될 때 예상보다 적은 수의 사용자가 오디언스 기준을 충족했을 수 있습니다(예: Segment에 포함되지 않았거나 필요한 속성이 없는 경우).
• 처리 진행 중: 메시지가 아직 활발히 처리 중일 수 있습니다. 사용자가 Canvas의 이전 단계에 아직 있고 메시지 단계에 도달하지 않았을 수 있습니다.
• 데이터 최신성: 대시보드 데이터는 약 15분마다 업데이트되지만 이는 보장되지 않습니다. 이 Campaign 또는 Canvas의 최신 데이터가 아직 대시보드에 반영되지 않았을 수 있습니다.
• 엣지 케이스: 현재 이 대시보드에서 포착되지 않는 엣지 케이스에 해당할 가능성이 적습니다. 이러한 경우가 의심된다면 Braze 지원팀에 문의하세요.

미전송과 전송됨의 합계가 Campaign 및 Canvas의 오디언스보다 큰 이유는 무엇인가요?

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

• 멀티채널 메시지: Campaign 또는 캔버스 단계가 여러 채널(예: SMS와 이메일)에서 전송되도록 구성되었습니다. 한 사용자가 하나의 채널(예: 이메일)에서는 “전송됨” 결과를, 다른 채널(예: “채널에 대한 사용자 부적격”)에서는 “중단” 결과를 받을 수 있습니다. 이 경우 해당 사용자는 차트에서 두 번 집계됩니다. 한 번은 “전송됨”, 한 번은 “중단”으로 집계됩니다.
  • 예: 100명의 사용자에게 iOS와 Android 모두를 타겟팅하는 푸시 Campaign을 보냅니다. 사용자가 iOS 기기만 보유한 경우 iOS 푸시를 수신(“전송됨”)하지만 Android 푸시에 대해서는 중단(“채널에 대한 사용자 부적격”)이 트리거됩니다.
• 다수의 메시지 단계(Canvas에만 해당): Canvas에 주어진 경로에 둘 이상의 메시지 단계가 있을 수 있습니다. 이 대시보드는 모든 결과를 집계하므로, 선택한 시간 범위 내에서 사용자가 여러 메시지 단계를 거치면 한 사용자가 여러 번 집계될 수 있습니다.
• 테스트 메시지: 테스트 전송(대시보드에서 집계됨)이 총 수를 오디언스 크기보다 높게 만들고 있습니다.