实时人群包追加设备号

向已创建的实时人群包中追加设备号，其中 group_id 为实时人群创建接口返回的 audience_id。

请求地址

https://openapi.aiclk.com/openapi/v1/dmp/audience/realtime_add_v2

所属权限

dmp

请求方式

POST

Header: Content-Type: application/json

请求参数

请求Url中添加参数：

字段名	类型	是否必须	描述
account_id	int	是	广告主ID(广告投放平台的userID)

Post-Body 添加参数：

字段名	类型	是否必须	描述
group_id	int	是	人群包ID，取实时人群创建接口返回的 audience_id
device_ids	[]string	是	oaid 明文数组，长度不大于 10 个
expire_time	int	是	秒级过期时间戳，不小于当前时间且不大于 30 天
encrypted	int	是	设备号是否加密，0：oaid 未 MD5，1：oaid 已 MD5

请求示例

curl --location 'https://openapi.aiclk.com/openapi/v1/dmp/audience/realtime_add_v2?account_id=1000002' \
  --header 'Content-Type: application/json' \
  --header 'OGW_ACCESS_TOKEN: YOUR_ACCESS_TOKEN' \
  --data '{
    "group_id": 1005532,
    "device_ids": ["b8d8f872-3a97-405a-a092-96929ddc7d1b"],
    "expire_time": 1775394680,
    "encrypted": 0
  }'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	接口信息
data	object	返回值，json格式
-status	bool	追加结果，true 表示成功
trace_id	string	请求链路ID

返回示例

{
  "code": 200,
  "data": {
    "status": true
  },
  "message": "success",
  "trace_id": "54f15da5377e7adc"
}