Как читать вкладку Errors
Если часть получателей не получила сообщение, вкладка Errors показывает почему. На ней перечислены неудачные отправки сообщения, чтобы вы могли узнать, что означает каждая ошибка, и исправить ее или выгрузить неудачные отправки.
Чтобы открыть вкладку, перейдите на страницу статистики сообщения и нажмите Errors рядом с Overview и Timeline.
Что показывает вкладка Errors
Anchor link toВкладка показывает неудачные отправки одного канала. Если сообщение было отправлено по нескольким каналам, вкладка показывает канал, выбранный над ней.
Неудачные отправки сгруппированы по платформам, например iOS, Android или Email. Нажмите на платформу, чтобы свернуть или развернуть ее ошибки. Каждая группа состоит из следующих частей:
- Строка платформы: сколько сообщений было отправлено на этой платформе, сколько из них не удалось отправить и какую долю целевой аудитории канала они составляют.
- Строки ошибок: по одной строке на ошибку, с ее названием и кодом, например Invalid To Phone Number (1001), и кратким описанием под ними. У каждой строки свое количество и своя доля той же аудитории.
Красный значок на вкладке Errors показывает число неудачных отправок в выбранном канале, включая Ошибки обработки. Если неудачных отправок нет, значка нет.
Когда вкладка пуста
Anchor link toВкладка показывает Ошибок доставки по этому сообщению нет в двух случаях:
- Ничего не завершилось ошибкой. Показывать нечего.
- Отправка сообщения не удалась еще до отправки (статус Failed). Ничего не было отправлено, поэтому показывать нечего. Это не означает, что сообщение было доставлено. Причина показана на вкладке Overview. См. Почему отправка сообщения не удалась.
Чего вкладка не показывает
Anchor link toНа вкладке перечислены только отправки, которые не удались до или во время передачи сообщения платформе доставки. На ней нет:
- Исключений из аудитории. Подписчиков, исключенных намеренно, например ограничением частоты, глобальной контрольной группой или из-за более ранней отписки. Вкладка 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), Phone Number Not Found (1007) для SMS | У подписчика нет push-токена, номера телефона или 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. |
Категории ошибок
Anchor link toДля каждой категории ниже указано, что пошло не так и что делать.
| Категория | Что это значит | Что делать |
|---|---|---|
| Недействительный или истёкший токен | Токен или адрес электронной почты больше не может получать сообщения, например потому что приложение удалено или адрес недействителен. | Часто встречается при отправке на большую аудиторию. Сравните с предыдущими отправками аналогичного размера. Углубляйтесь в анализ, только если доля таких ошибок значительно выросла. |
| Нет push-токена | У подписчика нет push-токена, адреса электронной почты, номера телефона или ID чата на этой платформе. | Для пушей попросите вашу команду разработчиков проверить, регистрирует ли приложение устройства. Для других каналов получите и зарегистрируйте контакт. |
| Устройство не найдено | Устройства нет в вашей аудитории Pushwoosh. | Часто возникает после применения фильтров сегментов или очистки аудитории. Проверьте, на кого была нацелена отправка. |
| Платформа отключена | Эта платформа отключена в проекте, или отключен API платформы доставки, например Firebase Cloud Messaging. | Включите платформу в конфигурации приложения или исключите ее из отправки. |
| Превышена квота провайдера | Apple, Google или другая платформа доставки ограничила отправку, или исчерпана ваша квота на отправку email. | Замедлите или разделите отправку. Если проблема повторяется, обратитесь в службу поддержки. |
| Недопустимое содержимое сообщения | Содержимое сообщения было отклонено (пустое или недопустимое). | Откройте пресет или текст сообщения и исправьте пустое или некорректное содержимое. |
| Неверная настройка платформы | Учетные данные приложения для этой платформы неверны или устарели (сертификаты, ключи и т. п.). | Проверьте настройки платформы в Control Panel или попросите службу поддержки / ваших разработчиков обновить учетные данные. |
| Ошибка провайдера | Платформа доставки сообщила о проблеме, или код не был распознан. | Несколько случаев обычно не являются проблемой. Если случаев много, обратитесь в службу поддержки Pushwoosh, указав дату сообщения и код сообщения. |
| Ошибка обработки | Что-то пошло не так при обработке на стороне Pushwoosh во время отправки. | Обратитесь в службу поддержки Pushwoosh. |
| Неклассифицированная ошибка | Ошибка не подошла ни к одной из известных групп. | Должна встречаться редко. Если вы видите много таких ошибок, обратитесь в службу поддержки, указав дату сообщения и код сообщения. |
Для SMS, Viber, WhatsApp, Telegram, Facebook Messenger, Kakao и LINE каждая ошибка, которую возвращает провайдер, попадает в Ошибка провайдера, какой бы ни была ее причина, включая лимиты отправки, неверные учетные данные и проблемы с шаблонами. Превышена квота провайдера и Неверная настройка платформы относятся только к пушам и email. Чтобы узнать, что означает такая ошибка, найдите ее название и код в разделе Ошибки SMS и мессенджеров.
Ошибки обработки
Anchor link toОшибки обработки — это сбои в собственной обработке Pushwoosh: при сборке сообщения, его передаче или чтении ответа платформы доставки. Они видны в двух местах:
- Вкладка Errors показывает их вместе с другими ошибками.
- На вкладке Overview воронка показывает их в отдельной строке, а не среди отклоненных отправок.
Выгрузка ошибок
Anchor link toНа вкладке можно выгрузить одну ошибку или все ошибки:
- Чтобы выгрузить получателей одной ошибки, нажмите значок загрузки рядом с этой ошибкой.
- Чтобы выгрузить все ошибки в один файл, нажмите Выгрузить ошибки.
Для выгрузки ошибок нужно и то и другое:
- Разрешение Personal data в вашей роли.
- Доступ к логам сообщений в вашем аккаунте.
Если значка загрузки и кнопки Выгрузить ошибки нет, попросите администратора аккаунта или службу поддержки проверить оба условия. У строк без кода нет значка загрузки. Чтобы включить их в выгрузку, используйте Выгрузить ошибки.