投递统计
OneSignal 将推送通知发送到推送服务（Google FCM、Apple APNs、华为 HMS），这些服务将通知投递到您用户的设备（订阅）。已投递、已取消订阅和失败的统计数据来自这些推送服务。确认投递和点击统计数据来自设备上的 OneSignal SDK。| 统计指标 | 定义 |
|---|---|
| 已发送 | 从 OneSignal 成功发送到推送提供商的消息数量。 |
| 总尝试次数 | 我们尝试发送的消息数量。包括成功发送到推送提供商的消息和失败的消息。这是一个衍生指标，是尝试发送到提供商时的成功、失败和错误的总和。 |
| 受众 | 目标分段中的订阅数量。 |
| 已投递 | 推送服务（FCM、APNs、HMS）报告已将通知投递到的推送订阅数量。与确认投递不同，后者由设备上的 OneSignal SDK 验证。 |
| 已取消订阅 | 因卸载应用、清除浏览器数据或退出推送并且之后没有打开应用而未接收消息的推送订阅数量。 |
| 失败 | 因错误而未接收到通知的推送订阅数量。未来消息仍会尝试发送到这些订阅。 |
| 已点击 | 通知的点击数量。 |
| 频率限制 | 因频率限制设置而未发送通知的推送订阅数量。 |
| 统计指标 | 定义 |
|---|---|
| 确认投递 | 确认接收消息的推送订阅数量。 |
| 剩余 | 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 天内的点击、会话和自定义结果（旧版，正在被转化指标取代）。使用它来查看参与度是在投递后立即发生的还是随时间持续发生的。
受众活动
受众活动报告显示每个订阅如何与特定消息互动。结果被分组到类别中，以便您可以诊断投递问题、衡量参与度、识别与特定消息相关的取消订阅，并为重新定位或导出分段受众。
- 类别
- 表格列
| 类别 | 描述 |
|---|---|
| 已发送 | 消息已发送到设备。 |
| 确认投递 | 投递已由设备确认。 |
| 未确认投递 | 未收到投递确认。 |
| 已点击 | 用户点击了通知。 |
| 未点击 | 用户未点击通知。 |
| 失败 | 投递失败。 |
| 已取消订阅 | 订阅在收到消息后取消订阅。 |
重新定位受众
从受众活动视图中，您可以直接向任何类别（例如，所有未点击的用户）发送重新定位消息。 这使得跟进未参与的用户、重新吸引流失的用户或加强确认投递的用户的成功变得容易。导出结果
您可以使用导出菜单下载受众数据：- 选定活动 – 仅导出当前查看的选项卡（例如，所有投递失败的用户）。
- 所有活动 – 导出每个类别的完整报告。
导出数据
将消息和用户数据导出为 CSV 以进行离线分析。
消息设置
消息设置面板显示用于发送的配置。- 受众 - 受众的详细信息，包括：
- 收件人总数 - 发送消息的订阅数量
- 消息发送方式：使用的目标过滤器或分段
- 计划 - 消息开始发送的时间以及选择的每用户投递选项（如有）。
- 限流 - 任何限流、频率限制或渠道覆盖
- 消息 - 消息内容。
- 目标平台（Android、iOS、特定浏览器）
- 高级设置 - 如优先级、生存时间和折叠 ID。
- 附加数据 - 添加到消息中的任何自定义数据。
常见问题
推送订阅状态何时更新？
推送订阅状态通过两种机制更新： 1. 当用户打开您的应用或网站时 OneSignal SDK 检查推送令牌是否有效以及是否仍然授予通知权限，然后立即更新订阅状态。 例如，如果用户在设备设置中禁用推送通知，然后重新打开您的应用，SDK 会立即检测到更改并将订阅标记为已取消订阅。 您可以使用 SDK 的订阅观察器（移动端 | Web 端）来捕获这些更改并将状态同步到您自己的数据库。 2. 当您发送推送通知时 如果用户卸载了您的应用、清除了浏览器数据或禁用了推送并且再也没有返回，OneSignal 在您发送通知之前无法检测到这一变化。推送服务（FCM、APNs、HMS）会将令牌报告为无效，OneSignal 将订阅标记为已取消订阅。 这种检测通常需要 2 条或更多消息，因为推送服务不会立即拒绝无效令牌：| 发送 | 发生情况 |
|---|---|
| 消息 1 | 投递到设备。用户随后在设备设置中取消订阅或卸载应用。 |
| 消息 2 | 推送服务接受消息，但设备未收到。OneSignal 报告”已投递”，因为推送服务尚未拒绝令牌。 |
| 消息 3 | 推送服务拒绝令牌。OneSignal 将订阅标记为已取消订阅。 |
| 消息 4+ | OneSignal 不会尝试向此订阅投递。 |
为什么我的已投递数量与确认投递不匹配？
已投递反映的是推送服务（FCM、APNs）报告的内容——它接受了消息进行投递。确认投递需要设备上的 OneSignal SDK 回报，这只有在设备在线且应用处理通知时才会发生。离线设备、强制关闭应用的设备或缺少 SDK 的设备将显示为已投递但未确认。受众活动数据可用多长时间？
受众活动数据自消息发送起保留 30 天。如果需要保留更长时间，请在此窗口关闭前导出结果。相关页面
确认投递
设备级投递确认的工作原理以及影响确认率的因素。
统计术语表
所有渠道的投递、参与度和转化指标的定义。
模板分析
使用模板跟踪推送通知跨发送的性能。
推送限流
控制投递速率以管理高容量发送期间的服务器负载。