此SDK已停止维护，请开发者对接 RestApi V2

统计API

简述

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

【推送】获取推送结果

功能描述

调用此接口查询推送数据，可查询消息有效可下发总数，消息回执总数等结果。

限制说明

此接口调用，需要是toList或toApp的taskId才可以查询推送结果数据。

接口名称

getPushResult（$taskId）

请求参数

返回参数

GT 和 APN

返回示例

{
    "result": "ok",
    "taskId": "",
    "msgProcess":"",
    "clickNum":"",
    "pushNum":"",
    "feedbackTotal":"",
    "clickTotal":"",
    "displayTotal":"",
    "sentTotal":"",
    "GT": {//个推下发
        "sent": "",//成功下发数
        "displayed": "",//展示数
        "clicked": "",//点击
        "feedback": "",//到达
        "result": ""//成功(ok)或错误信息
    },
    "APN": {//ios apn下发
        "sent": "",//下发
        "displayed": "",//展示
        "clicked": "",//点击
        "feedback": "",//到达
        "result": ""//成功(ok)或错误信息
    }
}

【推送】批量获取推送结果

功能描述

调用此接口批量查询推送数据，可查询消息有效可下发总数，消息回执总数，用户点击数结果。

限制说明

此接口调用，需要是toList或toApp的taskId才可以查询推送结果数据。

接口名称

function getPushResultByTaskidList($taskIdList)

请求参数

返回示例

{
  "result": "ok",
  "resultList":[
      {
        "taskId":"",
        "msgProcess":"",//个推达到数
        "clickNum":"",//个推点击数
        "pushNum":"",//个推下发数
        "feedbackTotal":"",//各渠道总到达数
        "clickTotal":"",//各渠道总点击数
        "displayTotal":"",//各渠道总展示数
        "sentTotal":"",//各渠道总下发数
        "GT": {//个推下发报表
            "sent": "",//成功下发数
            "displayed": "",//展示数
            "clicked": "",//点击
            "feedback": "",//到达
            "result": ""//成功(ok)或错误信息
        },
        "APN": {//ios apns下发
            "sent": "",//下发
            "displayed": "",//展示
            "clicked": "",//点击
            "feedback": "",//到达
            "result": ""//成功(ok)或错误信息
        }
      }
  ]
}

【推送】获取任务组名推送结果

功能描述

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

接口名称

getPushResultByGroupName($appId,$groupName)

请求参数

返回参数

GT 和 APN

返回示例

{
    "result": "ok",
    "groupName": "",
    "msgTotal":"",
    "msgProcess":"",
    "clickNum":"",
    "onlineNum":"",
    "feedbackTotal":"",
    "clickTotal":"",
    "displayTotal":"",
    "sentTotal":"",
    "GT": {//个推下发
        "sent": "",//成功下发数
        "displayed": "",//展示数
        "clicked": "",//点击
        "feedback": "",//到达
        "result": ""//成功(ok)或错误信息
    },
    "APN": {//ios apn下发
        "sent": "",//下发
        "displayed": "",//展示
        "clicked": "",//点击
        "feedback": "",//到达
        "result": ""//成功(ok)或错误信息
    }
}

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

功能描述

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

接口名称

queryAppPushDataByDate(APPID,DATE)

请求参数

返回参数

data

GT 和 APN

返回示例

{
    "result": "ok",
    "data": {
        "appId":"",
        "date":"",
        "sendCount":"",//个推预计下发数
        "sendOnlineCount":"",//个推下发数
        "receiveCount":"",//个推达到数
        "showCount":"",//个推展示数
        "clickCount":"",//个推点击数
    },
    "GT": {//个推下发
        "sent": "",//成功下发数
        "displayed": "",//展示数
        "clicked": "",//点击
        "feedback": "",//到达
        "result": ""//成功(ok)或错误信息
    },
    "APN": {//ios apns下发
        "sent": "",//下发
        "displayed": "",//展示
        "clicked": "",//点击
        "feedback": "",//到达
        "result": ""//成功(ok)或错误信息
    }
}

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

功能描述

通过接口查询当前时间一天内的在线数（十分钟一个点，一小时六个点）

接口名称

getLast24HoursOnlineUserStatistics($appId)

请求参数

返回值

返回示例

{
    "result":"ok",
    "appId":"",
    "onlineStatics":{
        "1565774989870":10,   //每一个时间点的数据
        "1565771049870":20
    }
}

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

功能描述

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

接口名称

queryAppUserDataByDate(APPID , DATE)

请求参数

返回参数

data

返回示例

{
    "result":"Success",
    "data":{
        "appId":"",
        "date":"yyyyMMdd",
        "newRegistCount":0, //新注册用户数
        "registTotalCount":0, //累计注册用户数
        "activeCount":0, //活跃用户数
        "onlineCount":0 //最高同时在线用户数
    }
}

【用户】查询符合条件的用户数

功能描述

通过接口查询符合当前查询条件的用户数

接口名称

queryUserCount($appId, $appConditions)

请求参数

返回参数

返回示例

{
    "result":"Success",
    "user_count":123
}

【用户】查询用户画像

功能描述

通过接口查询个推大数据得出的用户画像标签，该接口需要申请后才可正常使用，且主要是让APP查看自己能使用哪些标签进行推送

限制说明

申请用户画像标签请点击右侧“技术咨询”了解详情 。

接口名称

getPersonaTags(APPID)

请求参数

返回参数

返回示例

{
    "result":"Success",
    "tags":[
        {
            "group":"", //标签类型
            "desc":"",  //类型描述
            "list":[
                {
                    "id":"",  //标签ID
                    "desc":"" //标签描述
                }
            ]
        }
    ]
}