跳到内容

如何查看 Errors 选项卡

当部分收件人没有收到您的消息时,Errors 选项卡会显示原因。它列出该消息发送失败的记录,您可以 查找每个错误的含义 并加以修复,或 导出发送失败的记录。

要打开该选项卡,请进入该消息的消息统计页面,然后点击 Overview 和 Timeline 旁边的 Errors。

Errors 选项卡显示的内容

Anchor link to

该选项卡显示一个渠道的发送失败记录。如果消息通过多个渠道发出,该选项卡会显示您在其上方选择的渠道。

发送失败的记录按平台分组,例如 iOS、Android 或 Email。点击平台即可折叠或展开其错误。每个分组包含以下部分:

  • 平台行: 在此平台上发送了多少条消息、失败了多少条,以及它们占该渠道符合条件受众的比例。
  • 错误行: 每个错误一行,显示其名称和代码,例如 Invalid To Phone Number (1001),下方附有简短说明。每一行都有自己的数量及其占同一受众的比例。
按平台划分的投递错误,显示 iOS、Android 和 Huawei 的错误明细及数量和百分比

Errors 选项卡上的红色徽标表示所选渠道中发送失败的数量,包括 处理错误。没有发送失败时不显示徽标。

选项卡为空的情况

Anchor link to

在以下两种情况下,该选项卡会显示 此消息没有送达错误:

  • 没有任何发送失败。 没有可列出的错误。
  • 消息在发送前就已失败(状态为 Failed)。没有任何内容被发送,因此没有可列出的内容。这并不意味着消息已送达。失败原因会显示在 Overview 选项卡上。请参阅 消息发送失败的原因。

选项卡不显示的内容

Anchor link to

该选项卡只列出在 Pushwoosh 将消息交给投递平台之前或交接过程中失败的发送。它不会列出:

  • 受众排除。 被有意排除的订阅者,例如因频率上限 (frequency capping)、全局对照组或之前的退订而被排除。Overview 选项卡会在 已排除 行中显示他们。
  • 投递平台接收消息后的拒绝。 例如,运营商稍后未能投递的短信。此类发送在 Overview 选项卡上计为 网关已接收,在投递得到确认之前,还计为 送达未确认。
  • Pushwoosh 会重试的临时故障。 它们不会被记录为错误。

查找错误

Anchor link to

要了解某个错误的含义以及如何修复:

  1. 读取错误行中的名称和代码。不同的错误可能使用相同的代码,例如 Silent Hours (1041) 和 WhatsApp 错误 Template Is Paused (1041),因此也要查找名称。
  2. 在 所有平台上的错误 中查找它们。
  3. 如果那里没有,请打开 发送错误 下该行所属平台的页面。
  4. 如果该行显示的是类别名称而不是代码,例如 未分类错误,请在 错误类别 中查找。

Pushwoosh 会将每个错误归入以下类别之一。只有没有代码的错误,选项卡才会显示类别名称。

所有平台上的错误

Anchor link to

这些错误可能出现在任何平台上,从推送到短信和即时通讯应用。Pushwoosh 会在将消息交给投递平台之前或交接过程中报告它们。

错误
含义
怎么办
Push Token Not Found (1007),短信上为 Phone Number Not Found (1007)该订阅者在项目中没有此平台的推送令牌、电话号码或聊天 ID,因此 Pushwoosh 没有发送该消息。收集联系方式并在项目中 注册。
Platform Is Disabled (10005)该平台在项目中已关闭。在 Settings > Configure Platforms 中打开该平台。如果您不想在此平台上发送,请将其从消息中移除。
Skip Push (1011)某个占位符对该订阅者没有值,也没有默认值。在短信上,以及对于根据商品 feed 生成的文本,当填入占位符后文本为空时也会出现此错误。检查消息或预设中的占位符及其默认值。
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,服务商返回的每个错误都归入 服务商错误,无论其原因为何,包括发送限制、无效凭据和模板问题。超出服务商配额 和 平台配置无效 仅适用于推送和电子邮件。要了解此类错误的含义,请在 短信和即时通讯错误 中查找其名称和代码。

处理错误

Anchor link to

处理错误 是 Pushwoosh 自身处理过程中的故障:构建消息、交接消息或读取投递平台的回复。您会在两个地方看到它们:

  • Errors 选项卡将它们与其他错误一起列出。
  • 在 Overview 选项卡上,漏斗将它们显示为单独的一行,而不是在被拒发送下。

导出错误

Anchor link to

您可以导出选项卡上的单个错误或全部错误:

  • 要导出某个错误的收件人,请点击该错误旁边的 下载图标。
  • 要将所有错误导出到一个文件中,请点击 导出错误。

导出错误需要同时满足以下两项:

  • 您的角色拥有 Personal data 权限。
  • 您的账户可以访问消息日志。

如果下载图标和 导出错误 都没有显示,请让您的账户管理员或支持团队检查这两项。没有代码的行没有下载图标。请使用 导出错误 将它们包含在内。