跳转到主要内容
推送消息报告帮助您跟踪每个推送通知的性能,包括交付结果、用户参与度(CTR)、设备级确认和错误诊断。

推送消息报告的高级统计数据。


交付统计和结果定义

重要概念:
  • 推送订阅可以指移动和网页推送订阅,具体取决于消息中使用的受众和设置。
  • OneSignal(像所有推送提供商一样)将推送通知发送到推送服务(Google (FCM)、Apple (APNs)、华为 (HMS) 等),然后由这些服务将通知发送给您的用户。
  • 已投递、已取消订阅和失败的响应来自推送服务。
  • 确认投递和点击响应来自 OneSignal SDK。
MetricDefinition
受众包含在分段中的推送订阅数量,排除重复和任何在排除分段中的订阅。
已发送受众中发送消息的推送订阅数量。排除已取消订阅、失败、剩余或被限制的订阅。
已投递推送服务成功接收的推送通知数量。
确认投递确认接收消息的推送订阅数量。
已取消订阅因卸载应用、清除浏览器数据或退出推送并且之后没有打开应用而未接收消息的推送订阅数量。
失败因错误而未接收消息的推送订阅数量。请参阅失败消息故障排除
剩余OneSignal 端仍在队列中等待发送的通知数量。
被限制频率限制设置而未发送的通知数量。
点击数消息的点击数量。
点击率计算公式为 (点击数 / 已投递) * 100%
确认点击率计算公式为 (点击数 / 确认投递) * 100%
影响打开接收通知后发生的应用打开数量,无需点击。基于设置 > 推送和应用内 > 影响打开中设置的时间窗口。

失败消息故障排除

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

交付状态

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

消息统计

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

显示结果图表以及自定义结果的图像

  • 通过 OneSignal API 发送的消息仅保存 30 天。
  • 使用模板分析跟踪消息性能随时间的变化。
  • 通过仪表板或 API导出您的消息数据。

受众活动

查看单个订阅结果,包括:
  • 已发送
  • 确认投递
  • 未确认
  • 已点击
  • 未点击
  • 失败
  • 已取消订阅
点击导出下载完整列表。 如果设备在设备列中显示 (),则表示该设备已被删除。

消息设置

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

I