帮你快速理解、总结文档立即下载
文档中心>移动推送>API 文档>统计相关接口>单条任务推送统计信息查询

单条任务推送统计信息查询

最近更新时间:2025-02-24 10:41:32
我的收藏

接口说明

请求方式: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
}
}
]
}