获取人群包
通过该接口可以查询账户可用的人群包信息
请求地址
https://openapi.aiclk.com/openapi/v1/conv/dmp/list
所属权限
ads_read
请求方式
GET
请求参数
URL中携带参数
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 广告主ID(广告投放平台的userID) |
请求示例
curl -X GET 'https://openapi.aiclk.com/openapi/v1/conv/dmp/list?account_id=1000002' \
-H 'OGW_ACCESS_TOKEN: your_access_token'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 返回信息 |
| data | []object | 返回结果 |
| - category_id | int | 类别ID |
| - category_name | int | 类别名称 |
| - type | int | 类别ID,枚举值: 0 - 用户自定义(自定义标签圈人、相似、扩展、上传包) 1 - 系统自定义 2 - 系统推荐-兴趣 3 - 系统推荐-运营推送的创建类型为标签圈人、组合、扩展、上传的包 |
| - audience_list | []object | 人群包列表 |
| -- audience_id | int | 人群包ID |
| -- audience_name | string | 人群包名称 |
| -- calculate_logic | string | 人群包计算逻辑 |
| -- overall_num | int | 总覆盖数 |
| -- audience_type | int | 人群包创建类型,枚举值: 0 - 标签圈人 1 - lookalike 2 - 组合运算 3 - 上传文件 4 - 系统推荐 |
| -- media_cover | []object | 媒体覆盖 |
| --- media_type | string | 媒体类别,枚举值 |
| --- count | int | 媒体覆盖数 |
返回示例
{
"code": 200,
"message": "success",
"data": [
{
"category_id": 0,
"type": 0,
"category_name": "自定义标签圈人包",
"audience_list": [
{
"audience_id": 2704914,
"audience_name": "推送测试3",
"calculate_logic": "推送测试3",
"overall_num": 0,
"media_cover": [
{
"media_type": "QTT",
"count": 0
},
{
"media_type": "MIDU",
"count": 0
}
],
"audience_type": 1
}
]
}
]
}