功能介绍
此接口用于获取数据报表,向媒体按天提供曝光、点击、收益等统计数据。
接口原型
| 承载协议 | 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": "测试-多条快卡"
- }
- ]
- }
该接口用于媒体获取曝光、点击、收益等统计报告。通过HTTPSPOST请求,使用client_id和access_token进行认证,提供startDate和endDate获取指定日期范围内的数据,一次最多处理100个媒体信息。
227

被折叠的 条评论
为什么被折叠?



