메시지 활동 로그

메시지 활동 로그에서는 캠페인 및 전송과 관련된 모든 메시지(특히 오류 메시지)를 확인할 수 있습니다.

API 캠페인 트랜잭션을 확인하고, 실패한 메시지에 대한 세부 정보를 문제 해결하고, 알림 전달을 개선하거나 기존 기술 문제를 해결하는 방법에 대한 인사이트를 수집할 수 있습니다.

로그에 액세스하려면 설정 > 메시지 활동 로그로 이동합니다.

메시지 활동 로그에 기록된 다음 콘텐츠를 기준으로 필터링할 수 있습니다:

• 푸시 알림 오류
• 중단된 메시지 오류
• 웹훅 오류
• 메일 오류
• API 메시지 레코드
• 연결된 콘텐츠 오류
• REST API 연결 오디언스 오류
• 사용자 별칭 지정 오류
• A/B 테스트 오류
• SMS/MMS 오류
• WhatsApp 오류
• 라이브 활동 오류
• 잘못된 사용자 트리거 오류
• Braze 에이전트 일일 호출 한도 오류
• Braze 에이전트 사용 불가 모델 오류

이러한 메시지는 Braze 자체 시스템, 사용자의 앱 또는 플랫폼, 타사 파트너로부터 전송될 수 있습니다. 이로 인해 이 로그에 표시될 수 있는 메시지의 수는 무한히 많을 수 있습니다.

로그 메시지 이해

메시지의 의미를 파악하려면 각 메시지의 문구와 해당 열에 주의를 기울이세요. 문맥 단서를 활용하면 문제 해결에 도움이 됩니다.

예를 들어, 메시지에 “empty-cart_app”이라는 로그 항목이 있고 그 의미를 잘 모르겠다면, 왼쪽의 유형 열을 확인하세요. “중단된 메시지 오류”가 표시되면, 해당 메시지가 Liquid를 사용하여 중단 메시지로 작성된 것이며, 메시지의 의도된 수신자가 앱에서 빈 장바구니를 가지고 있었기 때문에 메시지가 중단되었다고 판단할 수 있습니다.

공통 메시지

몇 가지 일반적인 메시지 유형이 있으며, 일부 메시지는 문제를 진단하고 해결하는 데 도움이 되는 문제 해결 링크를 제공하기도 합니다.

다음에 나열된 메시지는 예시용이며 로그의 메시지 열에 표시되는 내용과 정확히 일치하지 않을 수 있습니다.

메시지 유형	잠재적 메시지	설명
소프트바운스	이메일 주소 [email protected]이 소프트바운스되었습니다.	이메일 주소는 유효하며 이메일 메시지가 수신자의 메일 서버에 도달했지만 ‘일시적인’ 문제로 인해 거부되었습니다. 일반적인 소프트바운스 이유는 다음과 같습니다: 사서함이 꽉 찼습니다(사용자가 할당량을 초과했습니다). 서버가 다운되었습니다. 메시지가 너무 커서 수신자의 받은편지함에 넣을 수 없습니다. 이메일이 소프트바운스된 경우, 일반적으로 72시간 이내에 재시도하지만, 재시도 횟수는 수신자마다 다릅니다.
하드바운스	연결하려는 이메일 계정이 존재하지 않습니다. 수신자의 이메일 주소에 오타나 불필요한 공백이 있는지 다시 한 번 확인하세요.	이 사람의 받은편지함에 메시지가 도달하지 못한 이유는 도달할 받은편지함이 없기 때문입니다. 더 자세히 알아보고 싶다면, 이러한 메시지에는 때때로 세부 정보 보기 열에 링크가 있어 의도된 수신자의 프로필을 확인할 수 있습니다.
차단	스팸 방지 정책으로 인해 스팸 메시지가 거부되었습니다.	메시지가 스팸으로 분류되었습니다. 이 메일 오류는 이메일 서비스 공급자로부터 이메일이 삭제되었음을 나타내는 이벤트를 수신한 경우 해당 사용자에 대해 기록됩니다. 해당 의도된 수신자에게만 해당될 수 있지만, 이 메시지를 자주 보고 있다면 발송 습관이나 메시지 내용을 재평가하는 것이 좋습니다. 또한 돌이켜 생각해 보세요—IP 워밍업을 하셨나요? 그렇지 않다면, 이를 시작하는 방법에 대한 조언을 위해 Braze에 문의하세요.
중단된 메시지 오류	empty-cart_web	장바구니가 있는 앱이 있거나 Liquid에서 중단 메시지가 포함된 전송을 생성한 경우 전송이 중단될 때 반환되는 메시지를 커스텀할 수 있습니다. 이 경우, 반환된 메시지는 empty-cart_web입니다.

내 메시지가 여기에 표시되지 않는 이유는 무엇인가요?

메시지 활동 로그의 메시지는 다양한 소스에서 올 수 있습니다: Braze, 앱 또는 플랫폼, 또는 타사 파트너. 즉, 이 로그에 나타날 수 있는 메시지는 무한히 많으며, 상상할 수 있듯이 모든 메시지를 나열할 수는 없습니다!

예를 들어, 앞의 표에 나열된 메시지 외에도 다음과 같은 잠재적인 “차단” 메시지가 있을 수 있습니다:

• 안타깝게도, [IP_ADDRESS]에서 보낸 메시지가 전송되지 않았습니다. 인터넷 서비스 공급자의 일부 네트워크가 차단 목록에 있으므로 해당 서비스 공급자에 문의하세요.
• 현지 정책으로 인해 메시지가 거부되었습니다.
• 수신자가 이 메시지를 스팸으로 차단했습니다.
• 서비스를 사용할 수 없습니다. 클라이언트 호스트 [IP_ADDRESS]가 Spamhaus에 의해 차단되었습니다.

저장 보존 기간

최근 60시간의 오류를 메시지 활동 로그에서 확인할 수 있습니다. 60시간이 지난 로그는 정리되어 더 이상 액세스할 수 없습니다.

저장되는 오류 로그 수

저장되는 로그 수는 여러 조건에 의해 영향을 받습니다. 예를 들어, 스케줄된 캠페인이 수천 명의 사용자에게 전송되는 경우, 모든 오류 대신 메시지 활동 로그에서 오류의 샘플만 볼 수 있습니다. 다음은 얼마나 많은 로그가 저장되는지에 영향을 미치는 조건의 개요입니다:

• 다음 오류 유형에 대해 동일한 캠페인 또는 캔버스 단계 내에서 고정된 1시간 동안 같은 오류 유형의 오류 로그가 최대 20개 저장됩니다:
  • 연결된 콘텐츠 오류
  • 메시지 중단 오류
  • 웹훅 오류
  • SMS 거부 오류
  • SMS 전달 실패 오류
  • WhatsApp 실패 오류
  • A/B 테스트 오류
• 다음 오류 유형에 대해 동일한 캠페인 또는 캔버스 단계 및 앱 조합에서 같은 오류 유형의 푸시 알림 오류 로그가 최대 20개 저장됩니다:
  • 유효하지 않은 푸시 자격 증명
  • 유효하지 않은 푸시 토큰
  • 푸시 자격 증명 없음
  • 토큰 오류
  • 할당량 초과
  • 재시도 시간 초과
  • 잘못된 페이로드
  • 예기치 않은 오류
• 다음 오류 유형에 대해 동일한 앱 내에서 고정된 1시간 동안 같은 오류 유형의 오류 로그가 최대 100개 저장됩니다:
  • 라이브 활동 오류 (푸시 자격 증명 없음)
  • 라이브 활동 오류 (잘못된 푸시 자격 증명)
  • 기타 라이브 활동 오류
  • APNs 피드백 제거된 토큰 오류
• 다음 오류 유형에 대해 동일한 캠페인 또는 캔버스 단계 내에서 고정된 1시간 동안 같은 오류 유형의 오류 로그가 최대 100개 저장됩니다:
  • 이메일 소프트바운스 오류
  • 이메일 하드바운스 오류
  • 이메일 차단 오류
• 동일한 워크스페이스 내에서 고정된 1시간 동안 최대 100개의 사용자 별칭 지정 오류 로그가 저장됩니다.

테스트 전송

메시지 활동 로그는 다음 메시징 채널에 대한 테스트 로그를 보여줍니다:

• SMS
• WhatsApp
• LINE
• KakaoTalk
• 웹훅

다음 채널에 대해서는 테스트 전송 로그를 사용할 수 없습니다: 이메일, 콘텐츠 카드, 인앱 메시지 및 푸시.

테스트 전송 로그에는 “[TEST SEND]” 접두사가 붙지만, 모든 테스트 전송 로그에 접두사가 붙는 것은 보장되지 않습니다(예: 연결된 콘텐츠 오류에는 접두사가 없습니다).