人群包洞察
通过人群包洞察接口,您可以查询人群包中人群画像的分布情况,包括年龄、性别和使用设备的操作系统。
请求地址
https://openapi.aiclk.com/openapi/v1/dmp/audience/distribution
所属权限
dmp
请求方式
GET
请求参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 广告主ID(广告投放平台的userID) |
| audience_id | int | 是 | 人群包ID |
请求示例
curl -X POST \
'http://openapi.aiclk.com/openapi/v1/dmp/audience/distribution?account_id=1000002&audience_id=2703402' \
-H 'OGW_ACCESS_TOKEN: your_access_token'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 接口信息 |
| data | object | 返回值,json格式 |
| age | list | 年龄分布(详细信息见年龄枚举) |
| os | list | 操作系统分布(详细信息见操作系统枚举) |
| city | list | 城市分布(城市以中文显示,other表示其他城市) |
| gender | list | 性别分布(详细信息见性别枚举) |
| key | string | 分布类型描述 |
| cover | string | 人群占比 |
返回示例
{
"code": 200,
"data": {
"age": [
{
"cover": 28.17,
"key": "COMMON"
},
{
"cover": 0.61,
"key": "BELOW_EIGHTEEN"
},
...
],
"city": [
{
"cover": 16.7,
"key": "滁州"
},
{
"cover": 0.11,
"key": "拉萨"
},
...
],
"os": [
{
"cover": 100,
"key": "ANDROID"
},
{
"cover": 0,
"key": "IOS"
}
],
"gender": [
{
"cover": 0.85,
"key": "COMMON"
},
{
"cover": 47.58,
"key": "MALE"
},
{
"cover": 51.57,
"key": "FEMALE"
}
]
},
"message": "success"
}