메시지 활동 로그
메시지 활동 로그를 통해 Campaigns 및 전송과 관련된 모든 메시지(특히 오류 메시지)를 확인할 수 있습니다.
API Campaign 트랜잭션을 확인하고, 실패한 메시지에 대한 세부 정보를 문제 해결하며, 알림 전달을 개선하거나 기존 기술 문제를 해결하는 방법에 대한 인사이트를 얻을 수 있습니다.
로그에 접근하려면 설정 > 메시지 활동 로그로 이동합니다.


이 문서 외에도 메시지 활동 로그를 사용하여 직접 문제 해결 및 디버깅을 수행하는 방법을 다루는 품질 보증 및 디버깅 툴 Braze 학습 과정도 확인하는 것을 권장합니다.
메시지 활동 로그에 기록된 다음 콘텐츠를 기준으로 필터링할 수 있습니다:
- 푸시 알림 오류
- 중단된 메시지 오류
- 웹훅 오류
- 메일 오류
- API 메시지 기록
- 연결된 콘텐츠 오류
- REST API 연결된 오디언스 오류
- 사용자 별칭 지정 오류
- A/B 테스트 오류
- SMS/MMS 오류
- WhatsApp 오류
- 라이브 활동 오류
- 잘못된 사용자 트리거 오류
- Braze Agents 일일 호출 한도 오류
- Braze Agents 사용 불가 모델 오류
이러한 메시지는 Braze 자체 시스템, 사용자의 앱 또는 플랫폼, 또는 서드파티 파트너로부터 올 수 있습니다. 따라서 이 로그에 표시될 수 있는 메시지의 수는 무한합니다.
로그 메시지 이해하기
메시지의 의미를 파악하려면 각 메시지의 문구와 해당 메시지에 대응하는 열에 주의를 기울이세요. 컨텍스트 단서를 활용하여 문제 해결에 도움이 될 수 있습니다.
예를 들어, 메시지에 “empty-cart_app”이라고 표시된 로그 항목이 있고 그 의미를 잘 모르겠다면, 왼쪽의 유형 열을 확인하세요. “Aborted Message Error”가 표시되면, 해당 메시지는 Liquid를 사용하여 중단 메시지로 작성된 것이며, 메시지의 의도된 수신자가 앱에서 빈 장바구니를 가지고 있었기 때문에 메시지가 중단되었다고 안전하게 추정할 수 있습니다.
일반적인 메시지
확인할 수 있는 몇 가지 일반적인 메시지 유형이 있으며, 일부는 문제를 진단하고 수정하는 데 도움이 되는 문제 해결 링크를 제공할 수도 있습니다.
다음에 나열된 메시지는 예시 목적이며 로그의 메시지 열에 표시되는 내용과 정확히 일치하지 않을 수 있습니다.
| 메시지 유형 | 잠재적 메시지 | 설명 |
|---|---|---|
| 소프트바운스 | 이메일 주소 [email protected]이 소프트바운스되었습니다. | 이메일 주소가 유효하고 이메일 메시지가 수신자의 메일 서버에 도달했지만 “일시적인” 문제로 거부되었습니다. 일반적인 소프트바운스 원인은 다음과 같습니다:
|
| 하드바운스 | 연결하려는 이메일 계정이 존재하지 않습니다. 수신자의 이메일 주소에 오타나 불필요한 공백이 없는지 다시 확인해 보세요. | 도달할 받은편지함이 없었기 때문에 메시지가 이 사람의 받은편지함에 도달하지 못했습니다. 더 자세히 알아보려면, 이러한 메시지에는 때때로 세부 정보 보기 열에 의도된 수신자의 프로필을 볼 수 있는 링크가 있을 수 있습니다. |
| 차단 | 스팸 방지 정책으로 인해 스팸 메시지가 거부되었습니다. | 메시지가 스팸으로 분류되었습니다. 이 메일 오류는 이메일 서비스 공급자로부터 이메일이 삭제되었다는 이벤트를 수신한 경우 사용자에 대해 기록됩니다. 해당 의도된 수신자에게만 해당될 수 있지만, 이 메시지가 자주 표시된다면 전송 습관이나 메시지 콘텐츠를 재평가해야 할 수 있습니다. 또한 IP 워밍업을 했는지 다시 생각해 보세요. 하지 않았다면 Braze에 문의하여 이를 시작하는 방법에 대한 조언을 받으세요. |
| 중단된 메시지 오류 | empty-cart_web | 장바구니가 있는 앱이 있거나 Liquid에서 중단 메시지가 포함된 전송을 생성하는 경우, 전송이 중단될 때 반환되는 메시지를 커스터마이즈할 수 있습니다. 이 경우 반환된 메시지는 empty-cart_web입니다. |
내 메시지가 여기에 나열되지 않는 이유는?
메시지 활동 로그의 메시지는 Braze, 사용자의 앱 또는 플랫폼, 서드파티 파트너 등 다양한 소스에서 올 수 있습니다. 이는 이 로그에 표시될 수 있는 메시지의 수가 무한하다는 것을 의미합니다. 상상할 수 있듯이 모든 메시지를 나열할 수는 없습니다!
예를 들어, 앞의 표에 나열된 것 외에 일부 잠재적인 “차단” 메시지는 다음과 같을 수 있습니다:
- Unfortunately, messages from [IP_ADDRESS] weren’t sent. Please contact your Internet Service provider since part of their network is on our block list.
- Message rejected due to local policy.
- The message was blocked by the receiver as spam.
- Service unavailable, Client host [IP_ADDRESS] blocked using Spamhaus.
저장 보존 기간
최근 60시간의 오류가 메시지 활동 로그에서 확인 가능합니다. 60시간이 지난 로그는 정리되어 더 이상 접근할 수 없습니다.
저장되는 오류 로그 수
저장되는 로그 수는 여러 조건에 의해 영향을 받습니다. 예를 들어, 스케줄된 Campaign이 수천 명의 사용자에게 전송되는 경우, 모든 오류 대신 메시지 활동 로그에서 오류의 샘플을 볼 수 있습니다. 다음은 저장되는 로그 수에 영향을 미치는 조건에 대한 개요입니다:
- 다음 오류 유형에 대해 동일한 Campaign 또는 캔버스 단계에서 1시간(고정 시계 시간) 내에 동일한 오류 유형의 오류 로그가 최대 20개까지 저장됩니다:
- 연결된 콘텐츠 오류
- 중단 메시지 오류
- 웹훅 오류
- SMS 거부 오류
- SMS 전달 실패 오류
- WhatsApp 실패 오류
- A/B 테스트 오류
- 다음 오류 유형에 대해 동일한 Campaign 또는 캔버스 단계 및 앱 조합에서 동일한 오류 유형의 푸시 알림 오류 로그가 최대 20개까지 저장됩니다:
- 유효하지 않은 푸시 자격 증명
- 유효하지 않은 푸시 토큰
- 푸시 자격 증명 없음
- 토큰 오류
- 할당량 초과
- 재시도 시간 초과
- 유효하지 않은 페이로드
- 예기치 않은 오류
- 다음 오류 유형에 대해 동일한 앱에서 1시간(고정 시계 시간) 내에 동일한 오류 유형의 오류 로그가 최대 100개까지 저장됩니다:
- 라이브 활동 오류 (푸시 자격 증명 없음)
- 라이브 활동 오류 (유효하지 않은 푸시 자격 증명)
- 기타 라이브 활동 오류
- APNs 피드백 제거된 토큰 오류
- 다음 오류 유형에 대해 동일한 Campaign 또는 캔버스 단계에서 1시간(고정 시계 시간) 내에 동일한 오류 유형의 오류 로그가 최대 100개까지 저장됩니다:
- 이메일 소프트바운스 오류
- 이메일 하드바운스 오류
- 이메일 차단 오류
- 동일한 워크스페이스에서 1시간(고정 시계 시간) 내에 사용자 별칭 지정 오류 로그가 최대 100개까지 저장됩니다.
테스트 전송
메시지 활동 로그는 다음 메시징 채널에 대한 테스트 로그를 표시합니다:
- SMS
- LINE
- KakaoTalk
- 웹훅
테스트 전송 로그는 이메일, Content Cards, 인앱 메시지, 푸시 채널에서는 사용할 수 없습니다.
테스트 전송 로그에는 “[TEST SEND]” 접두사가 붙지만, 모든 테스트 전송 로그에 접두사가 있다고 보장되지는 않습니다(예: 연결된 콘텐츠 오류에는 접두사가 없습니다).