统计推送数据
即时通讯服务提供推送统计数据功能,您可以在控制台推送成功率统计页面查看推送服务的统计数据。
提示
推送数据统计功能针对开发环境和生产环境都有效。
推送数据统计包括:
- 推送总量:表示实际需要推送的通知条数,包括第三方厂商推送和即时通讯自建推送服务(RongPush)。
- 推送成功总量:表示成功推送到第三方厂商推送服务、或即时通讯自建推送服务(RongPush)的通知数,推送成功并不代表实际已推送到了目标设备上。
- 推送失败总量:表示推送到第三方厂商推送服务、或即时通讯自建推送服务(RongPush)失败的通知数。
- 推送到达总量(需配置):表示手机设备实际已经收到的通知数,部分系统手机需要终端主动上报达到数据。
- 推送点击总量(需配置):表示终端用户点击通知总数,部分系统手机需要终端主动上报点击数据。
因第三方设计差异,即时通讯服务无法直接获取部分第三方推送厂商的推送到达和推送点击数据,需要您在第三方推送平台进行配置或者客户端自行上报。
采集推送到达数据
推送到达是指通知已发送到第三方厂商推送通道,或即时通讯自建推送服务(RongPush)后,推送通知成功下发到目标设备。
华为、魅族推送到达数据依赖手机厂商推送通道提供的「送达回执」服务。Google FCM 仅支持采集透传消息方式的推送到达数据。Apple APNs 必须在客户端手动上报。
详细支持情况参见下表:
推送平台 | 提供推送到达数据 | 是否需要配置 |
---|---|---|
华为 | 厂商支持 | 需要,参见配置华为推送回执 |
魅族 | 厂商支持 | 需要,参见配 置魅族推送回执 |
小米 | 厂商支持 | 无需配置 |
Vivo | 厂商支持 | 无需配置 |
OPPO(包括 Realme、OnePlus) | 厂商支持 | 无需配置 |
Google FCM | 厂商不支持,由客户端 SDK 提供 | 详见采集 FCM 推送到达数据 |
Apple APNs | 厂商不支持,由客户端 SDK 提供(要求 SDK ≧ 5.1.4) | 需要,需要 SDK 主动上报到达事件。参见上报推送数据 |
采集推送点击数据
推送点击数据是指表示终端用户点击通知的总数。
即时通讯服务可直接获取大部分厂商的推送通道的点击数据。如果即时通讯客户端 SDK 版本低于 5.2.3,华为推送通道下发的推送通知点击数据需要您在客户端手动上报。Apple APNs 必须在客户端手动上报。
详细支持情况参见下表:
推送平台 | 推送点击事件上报 | 是否需要配置 |
---|---|---|
RongPush | 支持 | 不需要,客户端 SDK 默认实现上报逻辑 |
小米 | 支持 | 不需要,客户端 SDK 默认实现上报逻辑 |
华为 | 支持(要求 SDK ≧ 5.1.4) | 从 IMLib 5.2.3 版本开始,客户端 SDK 默认实现上报逻辑(低于该版本则需要调用客户端 SDK 手动上报点击事件) |
Vivo | 支持 | 不需要,客户端 SDK 默认实现上报逻辑 |
魅族 | 支持 | 不需要,客户端 SDK 默认实现上报逻辑 |
OPPO | 支持 | 不需要,客户端 SDK 默认实现上报逻辑 |
Google FCM | 支持 | 不需要,客户端 SDK 默认实现上报逻辑 |
Apple APNs | 支持(要求 SDK ≧ 5.1.4) | 需要,需要 SDK 主动上报点击事件。参见上报推送数据 |