媒体方数据报表接口
接口
获取媒体方广告投放相关数据,数据时效(T+1日)
当前该接口权限需要联系内部运营手动添加
请求地址
https://openapi.aiclk.com/openapi/v1/outer_media/report
所属权限
outer_media
请求方式
GET
请求参数
请求参数字段:
| 字段名 | 类型 | 必须 | 描述 |
|---|---|---|---|
| query | string(json object) | 是 | 查询参数结构体,具体结构如下 |
query格式:
| 字段名 | 类型 | 必须 | 描述 |
|---|---|---|---|
| start_date | string | 是 | 开始日期,格式YYYY-MM-DD |
| end_date | string | 是 | 结束日期,格式YYYY-MM-DD |
请求Header
| Header名 | 必须 | 描述 |
|---|---|---|
| OGW_ACCESS_TOKEN | 是 | 分配的应用token |
请求示例
curl -X GET \
'https://openapi.aiclk.com/openapi/v1/outer_media/report?&query={start_date:2021-05-21,end_date:2021-05-21}' \
--header 'OGW_ACCESS_TOKEN: your_access_token'
返回字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 返回信息 |
| data | json | 返回值,json格式,包含如下字段 |
| - adslot_id | int | 广告栏位ID |
| - click | int | 点击 |
| - impression | int | 展现 |
| - ctr | float | 点击率 |
| - cost | int | 消耗,单位:分 |
| - ecpm | int | eCPM,单位:分 |
| - date | string | 日期 |
返回格式:
{
"code": 200,
"data": [
{
"adslot_id": 1,
"click": 20,
"cost": 2000,
"ctr": 0.02,
"date": "2021-05-21",
"ecpm": 2000,
"impression": 1000
}
],
"message": "success",
"trace_id": "5fcb6e37cbe2c3fd"
}