tencent cloud

移动推送

产品动态
公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
产品简介
产品概述
产品优势
应用场景
全球化部署
购买指南
价格总览
购买指引
计费模式
免费试用
欠费说明
快速入门
创建产品和应用
Android 快速接入
iOS 快速接入
创建推送任务
查询推送记录
推送测试方法指引
产品限制说明
操作指南
推送管理
推送高级功能
实践教程
iOS 平台角标功能实践
API 文档
简介
API 概览
调用方式
推送相关接口
标签相关接口
账号相关接口
统计相关接口
用户属性相关接口
服务端错误码
服务端 SDK
API（Java）
SDK 文档
Android 接入指南
iOS 接入指南
客户端集成插件
macOS接入指南
用户及权限
快速入门配置
进阶自定义配置
资源标签
服务协议
服务等级协议
开发者协议
常见问题
iOS 常见问题
Android 常见问题
Flutter 常见问题
其他问题
移动推送政策
移动推送隐私协议
TPNS 数据处理和安全协议
Developer Agreement
联系我们
词汇表
文档移动推送API 文档统计相关接口单条任务推送统计信息查询

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

PDF
聚焦模式
字号
最后更新时间： 2024-01-17 14:26:44

接口说明

请求方式：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：TPNS 通道
hw：华为通道
xm：小米通道
mz：魅族通道
oppo：OPPO 通道
vivo：vivo 通道
apns：APNs 通道
fcm：FCM 通道
rog：ROG 通道
apns: 苹果通道
iospk: 苹果 pushkit 通道，仅国际站支持
honor：荣耀通道
all：通道汇总
pushState
Object
pushState 结构变量见下表

PushState（Android）

参数名称
类型
说明
pushActiveUv
Integer
计划发送数
根据推送选定的符合目标人群筛选条件且开启了通知栏状态的90天内有联网的有效设备数。
pushOnlineUv
Integer
实际发送数
在计划发送设备数中，实际已经成功下发到厂商通道的或者通过 TPNS 通道对进程在线终端下发成功的有效设备数。
arrivalUv
Integer
抵达设备（包含 TPNS 通道及厂商通道抵达回执，其中华为、魅族通道抵达回执需要手动添加配置，详情可参考 厂商通道抵达回执获取指南）
verifySvcUv
Integer
抵达设备（仅 TPNS 通道、ROG 通道、FCM 通道有效。其他厂商通道由 TPNS 实际发送 pushOnlineUv 指标补齐）
注意：此字段后续会下线，抵达数据建议参考 arrivalUv 字段。
callbackVerifySvcUv
Integer
厂商通道抵达回执（华为、魅族通道抵达回执需要手动添加配置，详情可参考 厂商通道抵达回执获取指南）
注意：此字段后续会下线，抵达数据建议参考 arrivalUv 字段。
verifyUv
Integer
展示（已废弃，后续会下线此字段）
clickUv
Integer
点击
cleanupUv
Integer
清除
说明：
数组中“all” 通道对应汇总统计数据。
汇总数据中verifySvcUv（抵达设备），verifyUv（展示），clickUv（点击），cleanupUv（清除）指标只汇总计算了 TPNS 通道数据、ROG 通道数据、FCM 通道数据。
汇总数据中 pushActiveUv（计划发送）， pushOnlineUv（实际发送）汇总计算了 TPNS 通道 + 厂商通道的数据。
汇总数据中 callbackVerifySvcUv（厂商通道抵达回执）汇总计算了 厂商通道 callbackVerifySvcUv（厂商通道抵达回执）+ TPNS 通道 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,
                "verifySvcUv": 1000,
                "callbackVerifySvcUv": 800,
                "arrivalUv": 1000,
                "verifyUv": 1000,
                "clickUv": 0,
                "cleanupUv": 0
            }
        },
        {
            "channel": "mz",
            "pushState": {
                "pushActiveUv": 1000,
                "pushOnlineUv": 1000,
                "verifySvcUv": 1000,
                "callbackVerifySvcUv": 800,
                "arrivalUv": 1000,
                "verifyUv": 1000,
                "clickUv": 0,
                "cleanupUv": 0
            }
        },
        {
            "channel": "vivo",
            "pushState": {
                "pushActiveUv": 1000,
                "pushOnlineUv": 1000,
                "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": "xg",
            "pushState": {
                "pushActiveUv": 1000,
                "pushOnlineUv": 800,
                "verifySvcUv": 800,
                "callbackVerifySvcUv": 0,
                "arrivalUv": 1000,
                "verifyUv": 800,
                "clickUv": 300,
                "cleanupUv": 500
            }
        },
        {
            "channel": "oppo",
            "pushState": {
                "pushActiveUv": 1000,
                "pushOnlineUv": 1000,
                "verifySvcUv": 1000,
                "callbackVerifySvcUv": 800,
                "arrivalUv": 1000,
                "verifyUv": 1000,
                "clickUv": 0,
                "cleanupUv": 0
            }
        },
        {
            "channel": "fcm",
            "pushState": {
                "pushActiveUv": 0,
                "pushOnlineUv": 0,
                "verifySvcUv": 0,
                "callbackVerifySvcUv": 0,
                "arrivalUv": 0,
                "verifyUv": 0,
                "clickUv": 0,
                "cleanupUv": 0
            }
        },
        {
            "channel": "rog",
            "pushState": {
                "pushActiveUv": 0,
                "pushOnlineUv": 0,
                "verifySvcUv": 0,
                "callbackVerifySvcUv": 0,
                "arrivalUv": 0,
                "verifyUv": 0,
                "clickUv": 0,
                "cleanupUv": 0
            }
        },
        {
            "channel": "all",
            "pushState": {
                "pushActiveUv": 6000,
                "pushOnlineUv": 5800,
                "verifySvcUv": 5800,
                "callbackVerifySvcUv": 4000,
                "arrivalUv": 5800,
                "verifyUv": 5800,
                "clickUv": 300,
                "cleanupUv": 500
            }
        }
    ]
}

上一篇: 单个任务推送信息查询下一篇: 多条任务统计数据聚合查询

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈