advertiser_id

long

必填

快手广告主ID

在获取accessToken的时候返回

template_name

string

必填

定向模板名称

名字需要唯一

auto_target

boolean

选填

过滤定向模版

默认：返回所有类型模版；false：只获取自定义定向模版；true ：只获取智能定向模版

target

struct

定向信息

如下

behavior_interest

struct

非必填

行为兴趣定向

intention_target

boolean

选填

行为意向-系统优选

行为意向是否开启系统优选，智能定向和行为意向系统优选不能同时开启

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行为-按分类

id不能重复且必须准确，具体id可通过下方标签接口获取；仅包含安卓数据，若操作系统定向IOS则无效；不能同时选择app_ids（旧标签体系字段，即将下线

app_interest_ids

long[]

可选（新）

APP行为-按分类

id不能重复且必须准确，具体id可通过下方标签接口获取；仅包含安卓数据，若操作系统定向IOS则无效；不能同时选择app_ids（新标签体系字段，替换app_interest，与app_interest同时传递，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

可选

智能扩量

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

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（不可突破）。

min   

int

可选

年龄最小值

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

max

int

可选

年龄最大值

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

behavior

struct

必填

行为定向

behavior与interest同时不传，则清空行为兴趣定向

interest

struct

选填

兴趣定向

behavior与interest同时不传，则清空行为兴趣定向

keyword

struct[]

非必填

行为定向关键词

根据/rest/openapi/v1/tool/keyword/query接口获取

label

string[]

非必填

行为定向 类目词

根据/rest/openapi/v1/tool/label/behavior_interest接口获取。将行为类目id从最高层类目id开始，以“-”连接起来，假如有一个类目id为80202，父类目id为802，最高层类目id为8，则此时应该写"8-802-80202"；如果想全选最高层类目"8"底下的所有子类目，填"8"

time_type

int

必填

在多少天内发生行为的用户

0:7天 1：15天 2：30天 3：90天 4：180天

strength_type

int

必填

行为强度

0：不限 1：高强度

scene_type

int[]

必填

行为场景

1：社区 2：APP 3：电商 4：推广

id

long

必填

关键词id

id与name需互相匹配

name

string

必填

关键词名称

id与name需互相匹配

label

string[]

非必填

兴趣定向类目词

根据/rest/openapi/v1/tool/label/behavior_interest接口获取。将兴趣类目id从最高层类目id开始，以“-”连接起来，假如有一个类目id为80202，父类目id为802，最高层类目id为8，则此时应该写"8-802-80202"；如果想全选最高层类目"8"底下的所有子类目，填"8"

strength_type

int

必填

兴趣标签强度

0：不限 1：高强度