功能介绍
此接口用于获取数据报表,向媒体按天提供曝光、点击、收益等统计数据。
接口原型
承载协议 | HTTPS POST |
---|---|
接口方向 | 开发者服务器->应用市场服务端 |
接口URL | https://connect-api.cloud.huawei.com/api/mas/v1/media/report/query |
数据格式 | 请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
请求参数
Header
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
---|---|---|---|
client_id | M | String | 客户端ID,获取方法请参见创建API客户端。 |
Authorization | M | String | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token的获取方式请参见获取Token。 |
Body
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
---|---|---|---|
requestId | M | String | 请求ID,长度32位,符合的正则匹配表达式为"^[A-Za-z0-9]+$"。 |
apiVersion | M | String | API版本号。 预留字段,当前请传入1。 |
startDate | M | String | 开始日期。 格式:yyyymmdd 说明 开始时间和结束时间跨度不超过30天。 |
endDate | M | String | 截止日期。 格式:yyyymmdd |
mediaInfo | M | Iist<ReportMediaInfo> | 媒体信息。 一次请求支持携带最多100个媒体信息。 |
请求示例
- {
- "requestId": "1231232***46757",
- "apiVersion": "1",
- "startDate":"20221016",
- "endDate":"20221016",
- "mediaInfo": [{
- "mediaPkgName":"xxx.com.huawei",
- "slotIds": [
- "CAOpUUHGd89",
- "F1iZagcgUb",
- "YTjixlaMDY7",
- "aMLhDhgOmU8",
- "c3tcoXKZFc6"
- ]
- }]
- }
响应参数
参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
---|---|---|---|
rtnCode | M | Integer | 返回码,参考错误码。 |
rtnDesc | M | String | 返回描述。 |
requestId | M | String | 请求参数原值返回。 |
reportInfos | M | Iist<MediaReportInfo> | 报表信息。 |
响应示例
- {
- "requestId": "123123214324325****435466546757",
- "rtnCode": 0,
- "reportInfos": [
- {
- "clickAmount": "10",
- "date": "20221016",
- "ecpm": 9.66,
- "estimatedBenefits": "9.69",
- "impression": "1003",
- "mediaName": "阅读",
- "mediaPkgName": "xxx.com.huawei",
- "requestAppAmounts": "49",
- "requestTimes": "50",
- "returnAmount": "19",
- "returnTimes": "20",
- "slotName": "测试-多条快卡"
- }
- ]
- }