跳转至

获取人群包

通过该接口可以查询账户可用的人群包信息

请求地址

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
                }
            ]
        }
    ]
}