메시지 활동 로그
메시지 활동 로그를 통해 캠페인 및 전송과 관련된 모든 메시지(특히 오류 메시지)를 확인할 수 있습니다.
API 캠페인 트랜잭션을 확인하고, 실패한 메시지에 대한 세부 정보를 문제 해결하고, 알림 전달을 개선하거나 기존 기술 문제를 해결하는 방법에 대한 인사이트를 얻을 수 있습니다.
로그에 액세스하려면 설정 > 메시지 활동 로그로 이동합니다.
이 문서 외에도 메시지 활동 로그를 사용하여 직접 문제 해결 및 디버깅을 수행하는 방법을 다루는 품질 보증 및 디버깅 툴 Braze 학습 과정도 확인해 보시기 바랍니다.
메시지 활동 로그에 기록된 다음 콘텐츠를 기준으로 필터링할 수 있습니다:
- 푸시 알림 오류
- 중단된 메시지 오류
- 웹훅 오류
- 메일 오류
- API 메시지 레코드
- 연결된 콘텐츠 오류
- REST API 연결 오디언스 오류
- 사용자 별칭 지정 오류
- A/B 테스트 오류
- SMS/MMS 오류
- WhatsApp 오류
- 실시간 활동 오류
- 잘못된 사용자 트리거 오류
이러한 메시지는 당사 시스템, 회원님의 앱 또는 플랫폼, 타사 파트너에서 발생할 수 있습니다. 이로 인해 이 로그에 나타날 수 있는 메시징의 수는 무한대로 늘어날 수 있습니다.
로그 메시지 이해하기
메시징의 의미를 파악하려면 각 메시지의 문구와 해당 메시지에 해당하는 열에 주의를 기울이면 문맥 단서를 사용하여 문제 해결에 도움이 될 수 있습니다.
예를 들어 메시지가 “empty-cart_app” 인 로그 항목이 있는데 그 의미가 무엇인지 잘 모르겠다면 왼쪽의 유형 열을 살펴보세요. ‘중단된 메시지 오류’가 표시되면 해당 메시지는 Liquid를 사용하여 중단 메시지로 작성된 것이며, 메시지 수신자의 앱에 빈 장바구니가 있어 메시징이 중단된 것으로 간주할 수 있습니다.
공통 메시지
몇 가지 일반적인 메시지 유형이 있으며, 일부 메시지는 문제를 진단하고 해결하는 데 도움이 되는 문제 해결 링크를 제공하기도 합니다.
다음 나열된 메시지는 예시용이며 로그의 메시지 열에 표시되는 내용과 정확히 일치하지 않을 수 있습니다.
| 메시지 유형 | 잠재적 메시지 | 설명 |
|---|---|---|
| 소프트 바운스 | [email protected] 이메일 주소가 소프트 바운스되었습니다. | 이메일 주소는 유효하며 이메일 메시지가 수신자의 메일 서버에 도달했지만 ‘일시적인’ 문제로 인해 거부되었습니다. 일반적인 소프트 바운스 원인은 다음과 같습니다:
|
| 하드 바운스 | 연결하려는 이메일 계정이 존재하지 않습니다. 수신자의 이메일 주소에 오타나 불필요한 공백이 있는지 다시 한 번 확인해 보세요. | 이 사람의 받은편지함이 없어서 메시지가 이 사람의 받은편지함에 도달하지 못했습니다. 좀 더 자세히 살펴보고 싶은 경우 이러한 메시징에는 세부정보 보기 열에 수신자의 프로필을 볼 수 있는 링크가 있는 경우가 있습니다. |
| 블록 | 스팸 방지 정책으로 인해 스팸 메시지가 거부되었습니다. | 메시징이 스팸으로 분류되었습니다. 이 메일 오류는 이메일 서비스 공급자로부터 이메일이 삭제되었음을 나타내는 이벤트를 받은 경우에 사용자에 대해 기록됩니다. 의도한 수신자를 위한 것일 수도 있지만, 이 메시지를 자주 받는다면 자신의 메시지 보내기 습관이나 메시지 내용을 다시 한 번 살펴볼 필요가 있습니다. 또한, IP 워밍업을 하셨나요? 그렇지 않은 경우 Braze에 문의하여 진행에 대한 조언을 구하세요. |
| 중단된 메시지 오류 | empty-cart_web | 장바구니가 있는 앱이 있거나 Liquid에서 중단 메시지가 포함된 전송을 생성하는 경우 전송이 중단된 경우 어떤 메시지가 반환되는지 커스텀할 수 있습니다. 이 경우 반환되는 메시지는 다음과 같습니다. empty-cart_web. |
내 메시징이 여기에 표시되지 않는 이유는 무엇인가요?
메시지 활동 로그의 메시지는 다양한 출처에서 올 수 있습니다: Braze, 회원님의 앱 또는 플랫폼 또는 타사 파트너. 즉, 이 로그에 나타날 수 있는 메시징은 무한히 많으며, 상상할 수 있듯이 모든 메시지를 나열할 수는 없습니다!
예를 들어, 앞의 표에 나열된 것 외에도 잠재적인 ‘차단’ 메시징이 있을 수 있습니다:
- 안타깝게도 [IP_ADDRESS] 으로부터 메시징이 전송되지 않았습니다. 네트워크의 일부가 차단 목록에 포함되어 있으므로 인터넷 서비스 공급자에게 문의하세요.
- 현지 정책으로 인해 메시징이 거부되었습니다.
- 수신자가 메시지를 스팸으로 차단했습니다.
- 서비스를 사용할 수 없음, 클라이언트 호스트 [IP_ADDRESS] 가 스팸하우스를 사용하여 차단되었습니다.
스토리지 보존 기간
지난 60시간 동안의 오류는 메시지 활동 로그에서 확인할 수 있습니다. 60시간이 지난 로그는 정리되어 더 이상 액세스할 수 없습니다.
저장된 오류 로그 수
저장되는 로그의 수는 여러 조건의 영향을 받습니다. 예를 들어 예약된 캠페인이 수천 명의 사용자에게 전송되는 경우 메시지 활동 로그에 모든 오류 대신 오류의 샘플이 표시될 수 있습니다. 다음은 저장되는 로그 수에 영향을 미치는 조건에 대한 개요입니다:
- 동일한 캠페인 또는 캔버스 단계에 대해 동일한 오류 유형의 오류 로그가 다음 오류 유형에 대해 정해진 시간 내에 최대 20개까지 저장됩니다:
- 연결된 콘텐츠 오류
- 메시지 오류 중단
- 웹훅 오류
- SMS 수신 거부 오류
- SMS 전달 실패 오류
- WhatsApp 실패 오류
- A/B 테스트 오류
- 동일한 캠페인 또는 다음 오류 유형에 대한 캔버스 단계 및 앱 조합에 대해 동일한 오류 유형의 푸시 알림 오류 로그가 최대 20개까지 저장됩니다:
- 잘못된 푸시 자격 증명
- 잘못된 푸시 토큰
- 푸시 자격 증명 없음
- 토큰 오류
- 할당량 초과
- 재시도 시간 초과
- 잘못된 페이로드
- 예기치 않은 오류
- 다음 오류 유형에 대해 동일한 오류 유형의 오류 로그가 동일한 앱에 대해 정해진 시간 내에 최대 100개까지 저장됩니다:
- 실시간 활동 오류(푸시 자격 증명 없음)
- 실시간 활동 오류(잘못된 푸시 자격 증명)
- 기타 실시간 활동 오류
- APN 피드백 토큰 오류 제거
- 동일한 캠페인 또는 캔버스 단계에 대해 동일한 오류 유형의 오류 로그가 다음 오류 유형에 대해 정해진 시간 내에 최대 100개까지 저장됩니다:
- 이메일 소프트 바운스 오류
- 이메일 하드 바운스 오류
- 이메일 차단 오류
- 동일한 작업 공간에 대해 정해진 시간 내에 최대 100개의 사용자 별칭 지정 오류 로그가 저장됩니다.
GitHub 에서 이 페이지를 편집합니다.