接口说明
请求方式:POST。
调用频率限制:200次/小时。
服务地址/v3/statistics/get_push_channel_stat_overview
接口功能: 查询某个时间段内每天各推送通道的推送转化汇总数据。
参数说明
请求参数
参数名称 | 必选 | 类型 | 描述 |
startDate | 是 | String | 查询开始日期 格式:YYYYMMDD 限制:只能查询最近6个月的数据 |
endDate | 是 | String | 查询截止日期,格式:YYYYMMDD |
应答参数
参数名称 | 类型 | 描述 |
retCode | Integer | 返回状态码 |
errMsg | String | 错误信息 |
pushDateChannelStat | Array | 返回结果:按天统计的结果数组。 数组单元素代表每天分通道的数据统计结果,由日期 date 和分通道统计数据数组 channelDatas 组成。channelDatas 单元素结构如下。 |
channelDatas
参数名称 | 类型 | 说明 |
channel | String | 推送通道名称 xg:移动推送自建通道 hw:华为通道 xm:小米通道 mz:魅族通道 oppo:OPPO 通道 vivo:vivo 通道 apns:APNs 通道 fcm:FCM 通道 rog:ROG 通道 apns: 苹果通道 iospk: 苹果 pushkit 通道,仅国际站支持 honor:荣耀通道 harmony:鸿蒙通道 |
pushState | Object |
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)
参数名称 | 类型 | 说明 |
pushActiveUv | Integer | 计划发送 |
pushOnlineUv | Integer | APNs 成功接收 |
pushRetryUv | Integer | 推送失败后重试的设备数 |
verifyUv | Integer | 终端应用层抵达设备数 |
verifySvcUv | Integer | 抵达 |
clickUv | Integer | 点击 |
示例说明
请求示例
{"startDate": "20200216","endDate": "20200216"}
应答示例
{"retCode": 0,"errMsg": "NO_ERROR","pushDateChannelStat": [{"date": "20200216","channelDatas": [{"channel": "xm","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,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "oppo","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 1000,"verifySvcUv": 1000,"callbackVerifySvcUv": 800,"arrivalUv": 1000,"verifyUv": 1000,"clickUv": 0,"cleanupUv": 0}},{"channel": "xg","pushState": {"pushActiveUv": 1000,"pushOnlineUv": 800,"verifySvcUv": 800,"callbackVerifySvcUv": 0,"arrivalUv": 1000,"verifyUv": 800,"clickUv": 300,"cleanupUv": 500}},{"channel": "all","pushState": {"pushActiveUv": 4000,"pushOnlineUv": 3800,"verifySvcUv": 3800,"callbackVerifySvcUv": 2400,"arrivalUv": 3800,"verifyUv": 3800,"clickUv": 300,"cleanupUv": 500}}]}]}