接口说明
请求方式:POST。
调用频率限制:200次/小时。
服务地址/v3/statistics/get_push_task_stat_channel
接口功能:查询每个推送任务的详细统计,包含所有通道信息及汇总结果。pushStatDataAll 里的通道类型会变化,根据 iOS/Android 和推送通道的不同而不同。
参数说明
请求参数
参数名称 | 必选 | 类型 | 描述 |
pushId | 是 | String | 推送任务 ID,限制查询当前日期起1个月内的推送任务 |
应答参数
参数名称 | 类型 | 描述 |
retCode | Integer | 返回状态码 |
errMsg | String | 错误信息 |
pushStatDataAll | Array | pushStatDataAll 结构变量见下表 |
pushStatDataAll
参数名称 | 类型 | 描述 |
channel | String | 推送通道名称: xg:移动推送自建通道 hw:华为通道 xm:小米通道 mz:魅族通道 oppo:OPPO 通道 vivo:vivo 通道 apns:APNs 通道 fcm:FCM 通道 rog:ROG 通道 apns: 苹果通道 iospk: 苹果 pushkit 通道,仅国际站支持 honor:荣耀通道 all:通道汇总 harmony:鸿蒙通道 |
pushState | Object | pushState 结构变量见下表 |
PushState(Android)
参数名称 | 类型 | 说明 |
pushActiveUv | Integer | 计划发送数,根据推送选定的符合目标人群筛选条件且开启了通知栏状态的90天内有联网的有效设备数。 |
pushOnlineUv | Integer | 实际发送数,在计划发送设备数中,实际已经成功下发到厂商通道的或者通过移动推送自建通道对进程在线终端下发成功的有效设备数。 |
arrivalUv | Integer | 抵达设备(包含移动推送自建通道及厂商通道抵达回执,其中华为、荣耀、鸿蒙和魅族通道抵达回执需要手动添加配置,华为、荣耀和魅族详情可参考 厂商通道抵达回执获取指南,鸿蒙详细可参考鸿蒙通道抵达回执获取指南) |
verifySvcUv | Integer | 抵达设备(仅移动推送自建通道、ROG 通道、FCM 通道有效。其他厂商通道由移动推送实际发送 pushOnlineUv 指标补齐) 注意:此字段后续会下线,抵达数据建议参考 arrivalUv 字段。 |
callbackVerifySvcUv | Integer | 注意:此字段后续会下线,抵达数据建议参考 arrivalUv 字段。 |
pushRetryUv | Integer | 推送失败后重试的设备数。 |
verifyUv | Integer | 展示(已废弃,后续会下线此字段)。 |
clickUv | Integer | 点击。 |
cleanupUv | Integer | 清除。 |
说明
数组中“all” 通道对应汇总统计数据。
汇总数据中verifySvcUv(抵达设备),verifyUv(展示),clickUv(点击),cleanupUv(清除)指标只汇总计算了移动推送自建通道数据、ROG 通道数据、FCM 通道数据。
汇总数据中 pushActiveUv(计划发送), pushOnlineUv(实际发送)汇总计算了移动推送自建通道 + 厂商通道的数据。
汇总数据中 callbackVerifySvcUv(厂商通道抵达回执)汇总计算了 厂商通道 callbackVerifySvcUv(厂商通道抵达回执)+移动推送自建通道 verifySvcUv(抵达设备)+ ROG 通道 verifySvcUv(抵达设备)+ FCM 通道 verifySvcUv(抵达设备)。
pushState(iOS 与 macOS)
参数名称 | 类型 | 说明 |
pushActiveUv | Integer | 计划发送 |
pushOnlineUv | Integer | APNs 成功接收 |
verifySvcUv | Integer | 抵达 |
clickUv | Integer | 点击 |
示例说明
请求示例
{"pushId": "130248"}
应答示例
{"retCode": 0,"errMsg": "NO_ERROR","pushStatDataAll": [{"channel": "xm","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 1000,"pushRetryUv": 0,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "mz","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 1000,"pushRetryUv": 0,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "vivo","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 1000,"pushRetryUv": 0,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "hw","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 1000,"pushRetryUv": 0,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "xg","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 800,"pushRetryUv": 0,"verifySvcUv": 800,"callbackVerifySvcUv": 0,"arrivalUv": 1000,"verifyUv": 800,"clickUv": 300,"cleanupUv": 500}},{"channel": "oppo","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 1000,"pushRetryUv": 0,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "fcm","pushState": {"pushActiveUv": 0,"pushOnlineUv": 0,"pushRetryUv": 0,"verifySvcUv": 0,"callbackVerifySvcUv": 0,"arrivalUv": 0,"verifyUv": 0,"clickUv": 0,"cleanupUv": 0}},{"channel": "rog","pushState": {"pushActiveUv": 0,"pushOnlineUv": 0,"pushRetryUv": 0,"verifySvcUv": 0,"callbackVerifySvcUv": 0,"arrivalUv": 0,"verifyUv": 0,"clickUv": 0,"cleanupUv": 0}},{"channel": "all","pushState": {"pushActiveUv": 6000,"pushOnlineUv": 5800,"pushRetryUv": 0,"verifySvcUv": 5800,"callbackVerifySvcUv": 4000,"arrivalUv": 5800,"verifyUv": 5800,"clickUv": 300,"cleanupUv": 500}}]}