分操作系统报表接口

接口

获取广告主操作系统展现、点击、消费金额等

请求地址

https://openapi.aiclk.com/openapi/v1/report/operate_system

所属权限

ads_read

请求方式

GET

请求参数

请求参数字段：

字段名	类型	必须	描述
account_id	number	是	查询的广告账户ID(广告投放平台的userID)
query	string（json object）	是	查询参数结构体,具体结构如下

query格式：

字段名	类型	必须	描述
start_date	string	是	开始日期，格式YYYY-MM-DD，时间跨度不超过7天
end_date	string	是	结束日期，格式YYYY-MM-DD，时间跨度不超过7天
filtering	object	否	过滤字段，允许值："campaign_id","adgroup_id","creative_id"

query例子

{
    "start_date": "2019-10-14", 
    "end_date": "2019-10-14", 
    "filtering": {
        "campaign_id": 121242,
        "adgroup_id": 234233,
        "creative_id": 333454
    }
}

请求示例

curl -X GET \
  'https://openapi.aiclk.com/openapi/v1/report/operate_system?account_id=1000004&query={"start_date":"2019-11-07","end_date":"2019-11-08","filtering":{"campaign_id":1000008}}' \
  -H 'OGW_ACCESS_TOKEN: your_access_token'

返回字段

字段名	类型	描述
code	int	返回码
message	string	返回信息
data	json	返回值，json格式
- os_type	string	系统类型 "IOS","ANDROID"
- impression	int	展现
- click	int	点击
- cost	int	消费现金，单位：分

返回格式：

{
    "code": 200,
    "data": [
        {
            "click": 5506,
            "cost": 161174,
            "impression": 111318,
            "os_type": "ANDROID"
        },
        {
            "click": 781,
            "cost": 2,
            "impression": 224,
            "os_type": "IOS"
        }
    ],
    "message": "success"
}