快手广告管理平台Marketing API开发文档《NO.23》

请求参数

字段

类型

说明

备注

advertiser_id

long

广告主ID

在获取access_token的时候返回

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

alliance_account

int

返回码

如果广告主id在白名单里面，值为1，如果不在白名单里面，值为0

请求样例

curl --location --request GET 'https://ad.e.kuaishou.com/rest/openapi/v1/advertiser/white_list' \

--header 'access-token: 847c1441cdb02bed258dc2b91d4e311d' \

--header 'Content-Type: application/json' \

--data-raw '{

  "advertiser_id": xxxxxxxx

}

返回样例

{

  "code": 0,

  "message": "OK",

  "data": {

      "alliance_account": 1

  }

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

广告主ID

在获取accessToken的时候返回

template_name

string

必填

定向模板名称

名字需要唯一

target

struct

定向信息

如下

target

字段

类型

是否必填

说明

备注

region

long[]

可选

地域

传值为 [] 表示不限，传递上一级 id 时，children id 可以不传，不允许同时传 parent id 和 children id，

地域信息可通过 [/region/list] 接口获取

district_ids

long[]

可选

商圈定向

与region字段不能同时传、白名单控制，最多选100个。

可以通过/rest/openapi/v1/region/district/list接口获取商圈信息

user_type

int

可选

用户类型

0：实时

1：常驻

2：不限

ages_range

int []

可选

可选年龄段

18：18-23岁

24：24-30岁

31：31-40岁

41：41-49岁

50：50-100岁

age

struct

可选

自定义年龄段

年龄最小限制，大于等于 18

min 和 max 年龄区间最小为 5 岁

gender

int

可选

性别

1：女性, 2：男性，0 表示不限

platform_os

int

可选

定向的 os 版本

应用安装类计划以app_id中的platform_os为准

1：Android，2：iOS，0 表示不限

android_osv

int

可选

Android 版本

3：不限，

4：4.x+，

5：5.x+，

6：6.x+，

7：7.x+

ios_osv

int

可选

iOS 版本

6：不限，

7：7.x+，

8：8.x+，

9：9.x+，

10：10.x+

network

int

可选

网络环境

1：WI-FI，2：移动网络，0：表示不限

filter_converted_level

int

可选

过滤已转化人群纬度

0：不限

1：广告组

2：广告计划

3：本账户

4：公司主体

5：APP

device_brand

int[]

可选

设备品牌

1：OPPO，2：VIVO， 3：华为，4：小米，5：荣耀，6：三星，7：金立，8：魅族，9：乐视，10：其他，11：苹果（只有 platform_os 为不限时支持此选项）；

传值为 [] 表示不限；

当 platform_os 表示 iOS 的时候，没有设备品牌定向

device_price

int[]

可选

设备价格，

1：1,500元以下，2：1,501~2,000，3：2,001~2,500，4：2,501~3,000，5、3,001~3,500，6：3,501~4,000，7：4,001~4,500，8：4,501~5,000，9：5,001~5,500，10：5,500元以上，传值为 [] 表示不限

business_interest_type

int

可选

商业兴趣类型

0：默认值

1：智能投放

2：兴趣标签

business_interest

long[]

可选

商业兴趣，

具体 id 可通过

/rest/openapi/v1/tool/targeting_tags/list

获取

当 business_interest_type 为 2 时必填，id 不能重复且必须准确

fans_star

long[]

可选

网红类别

id 不能重复且必须准确

interest_video

long[]

可选

兴趣视频，

id 不能重复且必须准确

app_interest

long[]

可选

APP行为-按分类

1、APP 行为分类选择，id 不能重复且必须准确；

2、只有「提升应用安装」的计划且 Android 应用支持此定向；其他计划填写无效；

3、iOS 不支持行为定向，填写无效；app_ids 和 app_interest 不能同时选择

app_ids

long[]

可选

APP行为-按APP名称

可通过 /rest/openapi/v1/tool/app/search

查询

1、APP 行为定向，id 不能重复且必须准确；

2、只有「提升应用安装」的计划且 Android 应用支持此定向；其他计划填写无效；

3、iOS 不支持行为定向，填写无效；app_ids 和 app_interest 不能同时选择

population

long[]

可选

定向人群包

可通过/rest/openapi/v1//dmp/population/list查询

1、定向人群包，人群包 id 不能重复且必须准确

2、人群包状态必须是已推送状态

paid_audience

long[]

可选

付费人群包

可通过/rest/openapi/v1//dmp/population/list查询

1、付费人群包，人群包 id 不能重复且必须准确

2、人群包状态必须是已推送状态，与定向、排除人群包互斥

exclude_population

long[]

可选

排除人群包

1、排除人群包，人群包 id 不能重复且必须准确；人群包状态必须是已推送状态

2、如果同时传了 population 和 exclude_population，则表示同时定向排除；

3、population 和 exclude_population 这两个字段不能包含交集的 id

intelli_extend

struct

可选

智能扩量

不传值表示不使用，传值具体见下方表格

intelli_extend

字段

类型

说明

备注

is_open

int

可选

开启智能扩量

默认为0，为1时打开智能扩量，其他数值报错；关闭智能扩量时，以下三个字段必须为0

no_age_break

int

可选

不可突破年龄

默认为0（可突破/无需控制），定向age数据不为空时，可设为1（不可突破）。

no_gender_break

int

可选

不可突破性别

默认为0（可突破/无需控制），定向gender数据不为空时，可设为1（不可突破）。

no_area_break

int

可选

不可突破地域

默认为0（可突破/无需控制），定向region数据不为空时，可设为1（不可突破）。

age

字段

类型

说明

备注

min

int

可选

年龄最小值

年龄最小限制，大于等于 18

max

int

可选

年龄最大值

年龄最大限制，少于等于 55