推送消息报告帮助您跟踪每个推送通知的性能，包括交付结果、用户参与度（CTR）、设备级确认和错误诊断。
交付统计和结果定义
重要概念：
- 推送订阅可以指移动和网页推送订阅，具体取决于消息中使用的受众和设置。
- OneSignal（像所有推送提供商一样）将推送通知发送到推送服务（Google (FCM)、Apple (APNs)、华为 (HMS) 等），然后由这些服务将通知发送给您的用户。
- 已投递、已取消订阅和失败的响应来自推送服务。
- 确认投递和点击响应来自 OneSignal SDK。
| Metric | Definition |
|---|
| 受众 | 包含在分段中的推送订阅数量，排除重复和任何在排除分段中的订阅。 |
| 已发送 | 受众中发送消息的推送订阅数量。排除已取消订阅、失败、剩余或被限制的订阅。 |
| 已投递 | 推送服务成功接收的推送通知数量。 |
| 确认投递 | 确认接收消息的推送订阅数量。 |
| 已取消订阅 | 因卸载应用、清除浏览器数据或退出推送并且之后没有打开应用而未接收消息的推送订阅数量。 |
| 失败 | 因错误而未接收消息的推送订阅数量。请参阅失败消息故障排除。 |
| 剩余 | OneSignal 端仍在队列中等待发送的通知数量。 |
| 被限制 | 因频率限制设置而未发送的通知数量。 |
| 点击数 | 消息的点击数量。 |
| 点击率 | 计算公式为 (点击数 / 已投递) * 100%。 |
| 确认点击率 | 计算公式为 (点击数 / 确认投递) * 100%。 |
| 影响打开 | 接收通知后发生的应用打开数量，无需点击。基于设置 > 推送和应用内 > 影响打开中设置的时间窗口。 |
失败消息故障排除
这些错误阻止了 OneSignal 向推送提供商投递消息：
| 错误 | 类型 | 故障排除步骤 |
|---|
| 401 Unauthorized | Web | 网页推送服务器给出了不明确的 401 错误。谨慎重试——可能导致重复发送。 |
| 404 Not Found | Web | 无效的推送订阅端点（令牌损坏）。 |
| Authentication Error | FCM | 检查您的 FCM 凭据，重新上传服务账户文件，然后重试。 |
| 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 天的点击、会话和自定义结果的图表。
- 通过 OneSignal API 发送的消息仅保存 30 天。
- 使用模板分析跟踪消息性能随时间的变化。
- 通过仪表板或 API导出您的消息数据。
受众活动
受众活动报告显示每个订阅如何与特定消息互动。结果被分组到类别中，以便您可以快速查看收件人如何参与。
| 类别 | 描述 |
|---|
| 已发送 | 消息已发送到设备。 |
| 确认投递 | 投递已由设备确认。 |
| 未确认投递 | 未收到投递确认。 |
| 已点击 | 用户点击了通知。 |
| 未点击 | 用户未点击通知。 |
| 失败 | 投递失败。 |
| 已取消订阅 | 订阅在收到消息后取消订阅。 |
| 列 | 描述 |
|---|
| External ID | 您的系统标识符（如果已设置）。 |
| OneSignal ID | 唯一的 OneSignal 用户 ID。 |
| Subscription ID | 唯一的订阅实例（设备 + 应用/浏览器）。 |
| Device | 浏览器或操作系统类型。如果您看到 ()，则设备已被删除。 |
| Subscription Status | 当前状态（例如，已订阅、已取消订阅）。 |
| Sent | 消息发送的时间。 |
| Confirmed Delivery | 设备确认投递的时间，如果没有则为 -。 |
| Clicked | 如果用户点击则为时间戳，否则为 -。 |
| Failed | 指示投递是否失败。 |
| Unsubscribed | 指示用户在收到消息后是否取消订阅。 |
| Failure message | 如果投递失败则为错误消息（例如，“Invalid token”）。 |
受众活动数据仅在消息发送后的 30 天内可用。如果您需要保留更长时间，请导出结果。
为什么受众活动有用
受众活动通过显示哪些特定用户属于每个结果，帮助您超越投递计数。使用它来：
- 诊断投递问题，通过查看失败或未确认的投递。
- 衡量参与度，通过比较点击与未点击。
- 跟踪流失，通过识别与消息相关的取消订阅。
- 分段受众，用于重新定位或导出。
重新定位受众
从受众活动视图中，您可以直接向任何类别（例如，所有未点击的用户）发送重新定位消息。
这使得跟进未参与的用户、重新吸引流失的用户或加强确认投递的用户的成功变得容易。
导出结果
您可以使用导出菜单下载受众数据：
- 选定活动 – 仅导出当前查看的选项卡（例如，所有投递失败的用户）。
- 所有活动 – 导出每个类别的完整报告。
导出允许您离线分析结果、与其他团队共享或与您的 CRM 和分析工具合并。
消息设置
本部分显示消息的详细信息，包括消息在投递前如何配置的可视化摘要。
- 受众 - 受众的详细信息，包括：
- 收件人总数 - 发送消息的订阅数量
- 消息发送方式：使用的目标过滤器或分段
- 计划 - 消息开始发送的时间以及选择的每用户投递选项（如有）。
- 限流 - 任何限流、频率限制或渠道覆盖
- 消息 - 消息内容。
- 高级设置 - 如优先级、生存时间和折叠 ID。
- 附加数据 - 添加到消息中的任何自定义数据。
