Skip to content

메시지 활동 로그

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

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

로그에 접근하려면 설정 > 메시지 활동 로그로 이동합니다.

메시지 활동 로그

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

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

이러한 메시지는 Braze 자체 시스템, 사용자의 앱 또는 플랫폼, 또는 서드파티 파트너로부터 올 수 있습니다. 따라서 이 로그에 표시될 수 있는 메시지의 수는 무한합니다.

로그 메시지 이해하기

메시지의 의미를 파악하려면 각 메시지의 문구와 해당 메시지에 대응하는 열에 주의를 기울이세요. 컨텍스트 단서를 활용하여 문제 해결에 도움이 될 수 있습니다.

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

일반적인 메시지

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

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

메시지 유형 잠재적 메시지 설명
소프트바운스 이메일 주소 [email protected]이 소프트바운스되었습니다. 이메일 주소가 유효하고 이메일 메시지가 수신자의 메일 서버에 도달했지만 “일시적인” 문제로 거부되었습니다.

일반적인 소프트바운스 원인은 다음과 같습니다:
  • 메일함이 가득 참 (사용자가 할당량을 초과함)
  • 서버가 다운됨
  • 메시지가 수신자의 받은편지함에 비해 너무 큼
이메일이 소프트바운스를 받은 경우, 일반적으로 72시간 이내에 재시도하지만 재시도 횟수는 수신자마다 다릅니다.
하드바운스 연결하려는 이메일 계정이 존재하지 않습니다. 수신자의 이메일 주소에 오타나 불필요한 공백이 없는지 다시 확인해 보세요. 도달할 받은편지함이 없었기 때문에 메시지가 이 사람의 받은편지함에 도달하지 못했습니다. 더 자세히 알아보려면, 이러한 메시지에는 때때로 세부 정보 보기 열에 의도된 수신자의 프로필을 볼 수 있는 링크가 있을 수 있습니다.
차단 스팸 방지 정책으로 인해 스팸 메시지가 거부되었습니다. 메시지가 스팸으로 분류되었습니다. 이 메일 오류는 이메일 서비스 공급자로부터 이메일이 삭제되었다는 이벤트를 수신한 경우 사용자에 대해 기록됩니다. 해당 의도된 수신자에게만 해당될 수 있지만, 이 메시지가 자주 표시된다면 전송 습관이나 메시지 콘텐츠를 재평가해야 할 수 있습니다. 또한 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
  • WhatsApp
  • LINE
  • KakaoTalk
  • 웹훅

테스트 전송 로그는 이메일, Content Cards, 인앱 메시지, 푸시 채널에서는 사용할 수 없습니다.

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