tencent cloud

文档反馈

推送统计按天聚合统计

最后更新时间:2024-11-19 14:11:08

    接口说明

    请求方式: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:荣耀通道
    pushState
    Object
    推送漏斗统计数据, 数据结构如下见 pushState。

    pushState(Android)

    参数名称
    类型
    说明
    pushActiveUv
    Integer
    计划发送
    根据推送选定的符合目标人群筛选条件且开启了通知栏状态的90天内有联网的有效设备数。
    pushOnlineUv
    Integer
    实际发送
    在计划发送设备数中,实际已经成功下发到厂商通道的或者通过移动推送自建通道对进程在线终端下发成功的有效设备数。
    arrivalUv
    Integer
    抵达设备数(包含移动推送自建通道及厂商通道抵达回执,其中华为、魅族通道抵达回执需要手动添加配置,详情可参考 厂商通道抵达回执获取指南
    verifySvcUv
    Integer
    抵达设备数(仅移动推送自建通道、ROG 通道、FCM 通道有效。其他厂商通道由移动推送实际发送 pushOnlineUv 指标补齐)
    注意:此字段后续会下线,抵达数据建议参考 arrivalUv 字段。
    callbackVerifySvcUv
    Integer
    厂商通道抵达回执(华为、魅族通道抵达回执需要手动添加配置,详情可参考 厂商通道抵达回执获取指南
    注意:此字段后续会下线,抵达数据建议参考 arrivalUv 字段。
    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 成功接收
    verifySvcUv
    Integer
    抵达
    clickUv
    Integer
    点击

    示例说明

    请求示例

    {
    "startDate": "20200216",
    "endDate": "20200216"
    }

    应答示例

    {
    "retCode": 0,
    "errMsg": "NO_ERROR",
    "pushDateChannelStat": [
    {
    "date": "20200216",
    "channelDatas": [
    {
    "channel": "xm",
    "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": "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
    }
    }
    ]
    }
    ]
    }