"> 统计API-个推文档中心

统计API

统计API

简述

所有统计报表都可以在开发者中心查看。点此查看使用说明,此处接口可以整合到开发者自身的系统中。

【推送】获取推送结果

查询推送数据,可查询消息有效可下发总数,消息回执总数和用户点击数等结果。支持单个taskId查询和多个taskId查询。
此接口调用,需要是toList或toApp的taskId才可以查询推送结果数据。

  • 接口地址: BaseUrl/report/push/task/$taskid,$taskid
  • 请求方式: GET

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
taskid String 任务id,推送时返回,多个taskId以英文逗号隔开,一次最多传200个

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

 {
    "code":0,
    "msg":"success",
    "data": {
        "$taskid": {
            "total": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            },
            "gt": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            }
        }
    }
}
名称 类型 描述
$taskid Json key: 任务编号,value: 统计数据
total Json 总的统计数据
gt Json key表示厂商通道,value表示该通道的统计数据。其中 gt: 个推通道; ios: APN;st: 坚果; key还可以是hw、xm、vv、mz、op。
target_num Number 目标下发数
receive_num Number 消息接收数
display_num Number 消息展示数
click_num Number 消息点击数

请求示例

curl $BaseUrl/report/push/task/$taskid,$taskid -H "token: xxx" 

【推送】任务组名查报表

根据任务组名查询推送结果,返回结果包括百日内联网用户数(活跃用户数)、实际下发数、到达数、展示数、点击数。

  • 接口地址: BaseUrl/report/push/task_group/$group_name
  • 请求方式: GET

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
group_name String 任务组名

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

 {
    "code":"0",
    "msg":"success",
    "data": {
        "$group_name": {
            "total": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            },
            "gt": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            },
            "ios": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            }
        }
    }
}
名称 类型 描述
$group_name Json key任务编号,value: 统计数据
total Json 总的统计数据
gt Json key表示厂商通道,value表示该通道的统计数据。其中 gt: 个推通道; ios: APN;st: 坚果; key还可以是hw、xm、vv、mz、op。
target_num Number 目标下发数
receive_num Number 消息接收数
display_num Number 消息展示数
click_num Number 消息点击数

请求示例

curl $BaseUrl/report/push/task_group/$group_name -H "token: xxx" 

【推送】获取单日推送数据

调用此接口可以获取某个应用单日的推送数据(推送数据包括:发送总数,在线发送数,接收数,展示数,点击数)(目前只支持查询非当天的数据)

  • 接口地址: BaseUrl/report/push/date/$date
  • 请求方式: GET

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
date String 日期,格式: yyyy-MM-dd

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

{
    "code":0,
    "msg":"success",
    "data": {
        "$date": {
            "total": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            },
            "gt": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            },
             "hw": {
                "target_num":2,
                "receive_num":2,
                "display_num":0,
                "click_num":0
            }
        }
    }
}
名称 类型 描述
$date Json key: 日期,格式: yyyy-MM-dd,value: 统计数据
total Json 总的统计数据
gt Json key表示厂商通道,value表示该通道的统计数据。其中 gt: 个推通道; ios: APN;st: 坚果; key还可以是hw、xm、vv、mz、op。
target_num Number 目标下发数
receive_num Number 消息接收数
display_num Number 消息展示数
click_num Number 消息点击数

请求示例

curl $BaseUrl/report/push/date/$date -H "token: xxx" 

【用户】获取单日用户数据接口

调用此接口可以获取某个应用单日的用户数据(用户数据包括:新增用户数,累计注册用户总数,在线峰值,日联网用户数)(目前只支持查询非当天的数据)

  • 接口地址: BaseUrl/report/user/date/$date
  • 请求方式: GET

Request请求说明:

路径参数说明(路径中$开头的参数)

名称 类型 是否必须 默认值 说明
date String 日期,格式: yyyy-MM-dd

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

{
    "code":0,
    "msg":"success",
    "data": {
        "$date": {
            "accumulative_num":9,
            "register_num":2,
            "active_num":5,
            "online_num":2
        }
    }
}
名称 类型 描述
$date Json key: 日期,格式: yyyy-MM-dd,value: 统计数据
accumulative_num Number 累计注册用户数
register_num Number 注册用户数
active_num Number 活跃用户数
online_num Number 在线用户数

请求示例

curl $BaseUrl/report/user/date/$date -H "token: xxx" 

【用户】获取24个小时在线用户数

查询当前时间一天内的在线用户数(10分钟一个点,1个小时六个点)

  • 接口地址: BaseUrl/report/online_user
  • 请求方式: GET

Request请求说明:

Header参数说明

名称 类型 是否必须 默认值 说明
token String 接口访问凭据,获取方式请参考获取鉴权token

Response响应说明

成功响应数据格式:

  • content-type:application/json;charset=utf-8

  • 返回值示例

{
    "code":0,
    "msg":"success",
    "data": {
        "online_statics":{
            "$date":4,
            "$date":5
        }
    }
}
名称 类型 描述
online_statics Json 在线用户统计数据
$date Number key: 毫秒时间戳,value: 在线用户数

请求示例

curl $BaseUrl/report/online_user -H "token: xxx" 
开发者中心 SDK 下载

文档中心搜索