推送消息报告

推送消息报告帮助您跟踪每个推送通知的性能，包括交付结果、用户参与度（CTR）、设备级确认和错误诊断。

---

​

交付统计和结果定义

重要概念：

• 推送订阅可以指移动和网页推送订阅，具体取决于消息中使用的受众和设置。
• OneSignal（像所有推送提供商一样）将推送通知发送到推送服务（Google (FCM)、Apple (APNs)、华为 (HMS) 等），然后由这些服务将通知发送给您的用户。
• 已投递、已取消订阅和失败的响应来自推送服务。
• 确认投递和点击响应来自 OneSignal SDK。

Metric	Definition
受众	包含在分段中的推送订阅数量，排除重复和任何在排除分段中的订阅。
已发送	受众中发送消息的推送订阅数量。排除已取消订阅、失败、剩余或被限制的订阅。
已投递	推送服务成功接收的推送通知数量。
确认投递	确认接收消息的推送订阅数量。
已取消订阅	因卸载应用、清除浏览器数据或退出推送并且之后没有打开应用而未接收消息的推送订阅数量。
失败	因错误而未接收消息的推送订阅数量。请参阅失败消息故障排除。
剩余	OneSignal 端仍在队列中等待发送的通知数量。
被限制	因频率限制设置而未发送的通知数量。
点击数	消息的点击数量。
点击率	计算公式为 (点击数 / 已投递) * 100%。
确认点击率	计算公式为 (点击数 / 确认投递) * 100%。
影响打开	接收通知后发生的应用打开数量，无需点击。基于设置 > 推送和应用内 > 影响打开中设置的时间窗口。

​

失败消息故障排除

这些错误阻止了 OneSignal 向推送提供商投递消息：

错误	类型	故障排除步骤
401 Unauthorized	Web	网页推送服务器给出了不明确的 401 错误。谨慎重试——可能导致重复发送。
404 Not Found	Web	无效的推送订阅端点（令牌损坏）。
AuthenticationError	FCM	迁移到最新的 FCM v1 API。
DeviceTokenNotForTopic	APNs	令牌的 Bundle ID 与您的 APNs 密钥或证书不匹配。在 p8 令牌或 p12 设置中修复。
Expired Certificate	APNs	您的 p12 证书已过期。请参阅证书设置。
FcmV1InvalidToken / Not Found	FCM	无效的推送令牌。检查 Firebase 凭据。设备必须重新打开应用以刷新令牌。
None / Missing	FCM	Firebase Cloud Messaging API 可能在您的项目中未启用。在 Firebase 控制台中激活并重试。
Permission Denied	FCM	检查完整错误消息以了解缺少哪个权限。更新服务账户文件的权限并重新上传至 OneSignal。
SenderIdMismatch	FCM	FCM v1 发送者 ID 不匹配。验证 Firebase 凭据。用户必须重新打开应用以获取更新的令牌。
TopicDisallowed	APNs	APNs 令牌不匹配。在 p8 配置中检查您的 Team ID、Key ID 和 Bundle ID。

---

​

交付状态

状态	描述
已投递	消息已完成发送到推送服务。
已计划	消息计划在未来投递。
发送中	消息正在发送中。
队列中	消息正在等待发送。
已取消	消息被手动取消。请参阅取消推送通知。
无收件人	发送时没有有效的受众（例如已取消订阅或不在分段中）。
失败	由于错误，OneSignal 无法发送消息。

---

​

消息统计

显示过去 30 天的点击、会话和自定义结果的图表。

---

​

受众活动

查看单个订阅结果，包括：

• 已发送
• 确认投递
• 未确认
• 已点击
• 未点击
• 失败
• 已取消订阅

点击导出下载完整列表。 如果设备在设备列中显示 ()，则表示该设备已被删除。

---

​

消息设置

本部分显示消息的详细信息，包括消息在投递前如何配置的可视化摘要。

• 受众 - 受众的详细信息，包括：
  • 收件人总数 - 发送消息的订阅数量
  • 消息发送方式：使用的目标过滤器或分段
• 计划 - 消息开始发送的时间以及选择的每用户投递选项（如有）。
• 限流 - 任何限流、频率限制或渠道覆盖
• 消息 - 消息内容。
  • 目标平台（Android、iOS、特定浏览器）
• 高级设置 - 如优先级、生存时间和折叠 ID。
• 附加数据 - 添加到消息中的任何自定义数据。

---