Errors 탭 읽는 방법
일부 수신자가 메시지를 받지 못한 경우 Errors 탭에서 그 이유를 확인할 수 있습니다. 이 탭은 메시지의 실패한 전송을 나열하므로 각 오류의 의미를 찾아보고 해결하거나 실패한 전송을 내보낼 수 있습니다.
탭을 열려면 해당 메시지의 메시지 통계 페이지로 이동하여 Overview 및 Timeline 옆에 있는 Errors를 클릭합니다.
Errors 탭에 표시되는 내용
Anchor link to이 탭은 하나의 채널에 대한 실패한 전송을 표시합니다. 메시지가 여러 채널로 발송된 경우 탭 위에서 선택한 채널이 표시됩니다.
실패한 전송은 플랫폼별(예: iOS, Android, Email)로 그룹화됩니다. 플랫폼을 클릭하면 해당 오류를 접거나 펼칠 수 있습니다. 각 그룹은 다음과 같이 구성됩니다.
- 플랫폼 행: 이 플랫폼에서 전송된 메시지 수, 실패한 메시지 수, 그리고 채널의 대상 오디언스 중 차지하는 비율.
- 오류 행: 오류당 한 행으로, 이름과 코드(예: Invalid To Phone Number (1001))와 그 아래 짧은 설명이 표시됩니다. 각 행에는 자체 개수와 동일한 오디언스 중 차지하는 비율이 표시됩니다.
Errors 탭의 빨간색 배지는 선택한 채널에서 실패한 전송 수이며, 처리 오류도 포함됩니다. 실패한 전송이 없으면 배지가 표시되지 않습니다.
탭이 비어 있는 경우
Anchor link to탭에는 다음 두 가지 경우에 이 메시지에 대한 전송 오류가 없습니다가 표시됩니다.
- 실패한 것이 없는 경우. 나열할 오류가 없습니다.
- 메시지가 전송되기 전에 실패한 경우 (상태 Failed). 아무것도 전송되지 않았으므로 나열할 항목이 없습니다. 이는 메시지가 전달되었다는 의미가 아닙니다. 원인은 Overview 탭에 표시됩니다. 메시지가 실패한 이유를 참조하세요.
탭에 표시되지 않는 내용
Anchor link to이 탭에는 Pushwoosh가 전송 플랫폼에 메시지를 넘기기 전이나 넘기는 동안 실패한 전송만 나열됩니다. 다음은 나열되지 않습니다.
- 오디언스 제외. 빈도 제한, 글로벌 대조군, 이전의 구독 취소 등으로 의도적으로 제외된 구독자입니다. Overview 탭의 제외 행에 표시됩니다.
- 전송 플랫폼이 메시지를 수락한 후의 거부. 예를 들어 통신사가 나중에 전달하지 못한 SMS입니다. 이러한 전송은 Overview 탭에서 게이트웨이 수락으로 집계되며, 전달이 확인될 때까지는 전달 미확인으로 집계됩니다.
- Pushwoosh가 재시도하는 일시적인 실패. 오류로 기록되지 않습니다.
오류 찾아보기
Anchor link to오류의 의미와 해결 방법을 알아보려면 다음을 수행합니다.
- 오류 행에서 이름과 코드를 확인합니다. 서로 다른 오류가 같은 코드를 사용할 수 있으므로(예: Silent Hours (1041) 및 WhatsApp 오류 Template Is Paused (1041)) 이름도 함께 찾아보세요.
- 모든 플랫폼의 오류에서 찾아봅니다.
- 찾을 수 없으면 전송 오류 아래에서 해당 행의 플랫폼 페이지를 엽니다.
- 행에 코드 대신 카테고리 이름(예: 분류되지 않은 오류)이 있으면 오류 카테고리에서 찾아봅니다.
Pushwoosh는 모든 오류를 이 카테고리 중 하나로 분류합니다. 탭에는 코드가 없는 오류에 대해서만 카테고리 이름이 표시됩니다.
모든 플랫폼의 오류
Anchor link to이 오류는 푸시부터 SMS, 메신저까지 모든 플랫폼에서 나타날 수 있습니다. Pushwoosh는 전송 플랫폼에 메시지를 넘기기 전이나 넘기는 동안 이 오류를 보고합니다.
| 오류 | 의미 | 조치 방법 |
|---|---|---|
| Push Token Not Found (1007), SMS의 Phone Number Not Found (1007) | 구독자에게 프로젝트 내 이 플랫폼의 푸시 토큰, 전화번호 또는 채팅 ID가 없어 Pushwoosh가 메시지를 전송하지 않았습니다. | 연락처를 수집하여 프로젝트에 등록하세요. |
| Platform Is Disabled (10005) | 프로젝트에서 플랫폼이 비활성화되어 있습니다. | Settings > Configure Platforms에서 플랫폼을 활성화하세요. 이 플랫폼으로 전송하지 않으려면 메시지에서 제거하세요. |
| Skip Push (1011) | 플레이스홀더에 이 구독자에 대한 값이 없고 기본값도 없습니다. SMS와 상품 피드로 구성된 텍스트의 경우, 플레이스홀더를 채운 후 텍스트가 비어 있을 때도 나타납니다. | 메시지 또는 프리셋에서 플레이스홀더와 기본값을 확인하세요. |
| Unable To Compile Liquid Template (1014) | 메시지에 Liquid 구문 오류가 있습니다. | 메시지 또는 프리셋에서 Liquid 템플릿을 수정하세요. |
| Silent Hours (1041) | 수신자가 채널의 방해 금지 시간 안에 있었고, 채널의 Message behavior가 Do not send입니다. 전달 실패가 아닙니다. | 수정할 것이 없습니다. 이 수신자에게 도달하려면 방해 금지 시간 없이 메시지를 보내거나 채널에 Send after the silence period ends를 선택하세요. |
| Internal Service Error (10006) | Pushwoosh가 전송 플랫폼에 넘기기 전이나 넘기는 동안 전송이 실패했습니다. 일부 플랫폼에서는 설정 오류도 포함하며, 전송 오류 아래의 해당 플랫폼 페이지를 참조하세요. | 반복되면 Pushwoosh 지원팀에 문의하세요. |
오류 카테고리
Anchor link to아래 각 카테고리는 무엇이 잘못되었고 무엇을 해야 하는지 알려줍니다.
| 카테고리 | 의미 | 조치 방법 |
|---|---|---|
| 유효하지 않거나 만료된 토큰 | 토큰 또는 이메일 주소가 더 이상 메시지를 수신할 수 없습니다. 예를 들어 앱이 삭제되었거나 주소가 유효하지 않은 경우입니다. | 대규모 오디언스에서 흔히 발생합니다. 비슷한 규모의 이전 전송과 비교해 보세요. 점유율이 크게 증가한 경우에만 더 깊이 파고드세요. |
| 푸시 토큰 없음 | 구독자에게 이 플랫폼의 푸시 토큰, 이메일 주소, 전화번호 또는 채팅 ID가 없습니다. | 푸시의 경우 개발팀에 앱이 기기를 등록하는지 확인하도록 요청하세요. 다른 채널의 경우 연락처를 수집하여 등록하세요. |
| 기기를 찾을 수 없음 | 기기가 Pushwoosh 오디언스에 없습니다. | 세그먼트 필터나 오디언스 정리 후에 종종 발생합니다. 누가 타겟이었는지 확인하세요. |
| 플랫폼 비활성화됨 | 프로젝트에서 이 플랫폼이 비활성화되어 있거나, 전송 플랫폼의 API(예: Firebase Cloud Messaging)가 비활성화되어 있습니다. | 앱 구성에서 플랫폼을 활성화하거나 전송에서 제거하세요. |
| 제공업체 할당량 초과 | Apple, Google 또는 다른 전송 플랫폼이 전송을 제한했거나, 이메일 전송 할당량을 모두 사용했습니다. | 전송 속도를 늦추거나 분할하세요. 계속 발생하면 지원팀에 문의하세요. |
| 유효하지 않은 메시지 콘텐츠 | 메시지 콘텐츠가 거부되었습니다 (비어 있거나 유효하지 않음). | 프리셋이나 메시지 텍스트를 열어 비어 있거나 손상된 콘텐츠를 수정하세요. |
| 유효하지 않은 플랫폼 설정 | 이 플랫폼의 앱 자격 증명(인증서, 키 등)이 잘못되었거나 오래되었습니다. | Control Panel에서 플랫폼 설정을 확인하거나, 지원팀/개발자에게 자격 증명 갱신을 요청하세요. |
| 제공업체 오류 | 전송 플랫폼에서 문제를 보고했거나 코드가 인식되지 않았습니다. | 몇 가지 경우는 보통 괜찮습니다. 많은 경우: 메시지 날짜와 메시지 코드를 가지고 Pushwoosh 지원팀에 문의하세요. |
| 처리 오류 | 전송 중 Pushwoosh 자체 처리 과정에서 오류가 발생했습니다. | Pushwoosh 지원팀에 문의하세요. |
| 분류되지 않은 오류 | 오류가 알려진 그룹에 속하지 않았습니다. | 드물게 발생해야 합니다. 많이 보인다면, 메시지 날짜와 메시지 코드를 가지고 지원팀에 문의하세요. |
SMS, Viber, WhatsApp, Telegram, Facebook Messenger, Kakao, LINE의 경우 제공업체가 반환하는 모든 오류는 원인과 관계없이 제공업체 오류 아래에 나열되며, 여기에는 전송 한도, 유효하지 않은 자격 증명, 템플릿 문제가 포함됩니다. 제공업체 할당량 초과 및 유효하지 않은 플랫폼 설정은 푸시와 이메일에만 적용됩니다. 이러한 오류의 의미를 알아보려면 SMS 및 메신저 오류에서 이름과 코드를 찾아보세요.
처리 오류
Anchor link to처리 오류는 메시지 생성, 전달, 전송 플랫폼의 응답 읽기 등 Pushwoosh 자체 처리 과정에서 발생한 실패입니다. 두 곳에서 확인할 수 있습니다.
- Errors 탭에 다른 오류와 함께 나열됩니다.
- Overview 탭의 퍼널에서 거부된 전송 아래가 아닌 자체 행으로 표시됩니다.
오류 내보내기
Anchor link to탭에서 하나의 오류 또는 모든 오류를 내보낼 수 있습니다.
- 하나의 오류에 대한 수신자를 내보내려면 해당 오류 옆의 다운로드 아이콘을 클릭합니다.
- 모든 오류를 하나의 파일로 내보내려면 오류 내보내기를 클릭합니다.
오류를 내보내려면 다음 두 가지가 모두 필요합니다.
- 역할에 Personal data 권한.
- 계정의 메시지 로그 접근 권한.
다운로드 아이콘과 오류 내보내기가 보이지 않으면 계정 관리자나 지원팀에 두 가지를 모두 확인해 달라고 요청하세요. 코드가 없는 행에는 다운로드 아이콘이 없습니다. 해당 행을 포함하려면 오류 내보내기를 사용하세요.