当前位置:主页 > 查看内容

移动推送 TPNS 单条任务推送统计信息查询 - API 文档

发布时间:2021-10-20 00:00| 位朋友查看

简介:接口说明 请求方式 :POST。 调用频率限制 :200次/小时。 服务地址/v3/statistics/get_push_task_stat_channel 接口服务地址与服务接入点一一对应,请选择与您的应用服务接入点对应的 服务地址。 接口功能 :查询每个推送任务的详细统计,包含所有通道信息……

接口说明

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

本站部分内容转载于网络,版权归原作者所有,转载之目的在于传播更多优秀技术内容,如有侵权请联系QQ/微信:153890879删除,谢谢!
上一篇:高级管理FAQ - 文件存储 NAS 下一篇:没有了

推荐图文

  • 周排行
  • 月排行
  • 总排行

随机推荐