跳转至

人群包洞察

通过人群包洞察接口,您可以查询人群包中人群画像的分布情况,包括年龄、性别和使用设备的操作系统。

请求地址

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