字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

campaign_id

long

必填

快手广告计划ID

unit_name

string

必填

快手信息流广告组名称

长度为1-100个字符，同一个计划下的快手广告组名称不能重复

bid_type

int

必填

优化目标出价类型：

2: CPC

6: OCPC

10：OCPM

bid

long

出价

bid_type为CPC/eCPC时该字段必填，单位：厘，不得低于0.2元，不得高于100元，不得高于组预算

cpa_bid

long

出价

bid_type是OCPC/OCPM时该字段必填，单位：厘，ocpx_action_type为2时，不得低于1元，不得高于3000元；

ocpx_action_type为180时，不得低于5元，不得高于3000元，部分白名单快手账户不得低于2元；

ocpx_action_type为53时，不得低于5元，不得高于3000元；

不得高于组预算

ocpx_action_type

int

优化目标

bid_type是OCPC时该字段必填

2：行为数（actionBar点击）

180：激活数

53：表单数

deep_conversion_type

int

深度转化目标

3:付费，7:次日留存，10:完件, 11:授信；13:添加购物车；14:提交订单；15:购买

快手联盟广告无门槛要求

下载类快手广告仅支持付费-3、次日留存-7

表单类快手广告仅支持付费-3、次日留存-7、完件-10、授信-11

deep_conversion_bid

long

深度转化目标出价

单位：厘，仅当deep_conversion_type可用且快手推广账户满足白名单时选填，出价需大于cpa_bid，小于min{组预算，3000元}，不得高于组预算，不支持从0改为其他值，也不支持从其他值改为0

scene_id

int[]

必填

资源位置

5：快手联盟广告

不支持与其他scene_id同时使用

unit_type

int

必填

创意制作方式

4: 自定义；5：程序化创意

begin_time

string

必填

投放开始时间

格式为yyyy-MM-dd，需大于等于当前时间

end_time

string

可选

投放结束时间

格式为yyyy-MM-dd，不传值表示从今天开始长期投放，传值表示设置开始时间和结束时间，且投放结束时间需大于等于投放开始时间

schedule_time

string

可选

投放时间段

格式为24*7位字符串，且都为0和1，以一个小时为最小粒度，从周一零点开始至周日24点结束；0为不投放，1为投放，不传/全传1/全传0视为全时段投放

day_budget

long

可选

单日预算金额

单位：厘，指定0表示预算不限，默认为0；

不小于100元，不超过100000000元，仅支持输入数字；

修改预算不得低于该广告组当日花费的120%，与day_budget_schedule不能同时传，不能低于组出价

day_budget_schedule

long[]

可选

分日预算

单位：厘，指定0表示预算不限，默认为0；

每天不小于100元，不超过100000000元，仅支持输入数字；

修改预算不得低于该快手广告组当日花费的120%，与day_budget不能同时传，均不能低于组出价

convert_id

int

可选

转化目标ID

计划类型为2时不支持；

计划类型为5时仅支持【JS代码】的转化目标

url

string

投放链接

当计划类型是5时必填；

长度不超过1000字符；

计划类型是5（收集销售线索）：落地页URL

app_id

long

应用ID

当计划类型为2时必填，可通过应用列表接口获取应用ID

show_mode

int

必填

创意展现方式

1 - 轮播

2 - 优选

speed

int

必填

投放方式

1 - 快速投放

2 - 平滑投放

target

struct

必填

定向数据

具体见下方表格

字段

类型

是否必填

说明

备注

region

long[]

可选

地域

传值为[]表示不限；传递上一级ID时，childrenID可以不传；不允许同时传parentID和childrenID；

地域信息可通过地域接口获取；

仅计划的campaign_type为5时，支持设置三级地域（例：山西-大同-左云，左云是三级地域）

age

struct

可选

自定义年龄段

不传值表示不限，传值具体见下方表格；

与ages_range不能同时传

ages_range

int[]

可选

固定年龄段

与age不能同时传；

【18：表示18-23岁】

【24：表示24-30岁】

【31：表示31-40岁】

【41：表示41-49岁】

【50：表示50-100岁】

gender

int

可选

性别

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

platform_os

int

可选

操作系统

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

当计划类型为2（提升应用安装）时该字段可忽略

android_osv

int

可选

Android版本

3：不限，4：4.x+，5：5.x+，6：6.x+，7：7.x+，8：8.x+，9：9.x+，10：10.x+；

当计划类型为2（提升应用安装）时，仅当app_id表示的是Android应用可使用此字段传递版本

ios_osv

int

可选

iOS版本

6：不限，7：7.x+，8：8.x+，9：9.x+，10：10.x+；

当计划类型为2（提升应用安装）时，仅当appId表示的是iOS应用可使用此字段传递版本

network

int

可选

网络环境

1：Wi-Fi，2：移动网络，0：表示不限

device_brand

int[]

可选

设备品牌

传值为[]表示不限；

当platform_os为2（iOS）时，没有设备品牌定向；

1：OPPO，2：VIVO，

3：华为，4：小米，

5：荣耀，6：三星，

7：金立，8：魅族，

9：乐视，10：其他，

11：苹果（只有 platform_os为不限时支持此选项）

device_price

int[]

可选

设备价格

传值为[]表示不限；

1：1500元以下，

2：1501~2000，

3：2001~2500，

4：2501~3000，

5：3001~3500，

6：3501~4000，

7：4001~4500，

8：4501~5000，

9： 5001~5500，

10：5500元以上

app_interest

long[]

可选

APP行为-按分类

id不能重复且必须准确，具体id可通过下方标签接口获取；

仅包含安卓数据，若操作系统定向IOS则无效；

不能同时选择app_ids

app_ids

long[]

可选

APP行为-按APP名称

id不能重复且必须准确，具体id可通过下方应用接口获取，建议不超过10个，否则可能出现报错；

仅包含安卓数据，若操作系统定向IOS则无效；不能同时选择app_interest

population

long[]

可选

人群包定向

人群包id不能重复且必须准确，具体id可通过人群管理模块的接口获取；

人群包状态必须是已推送状态；

不能和exclude_population的id有交集

exclude_population

long[]

可选

人群包排除

人群包id不能重复且必须准确，具体id可通过人群管理模块的接口获取；

人群包状态必须是已推送状态；

不能和population的id有交集

media

long[]

选填

媒体定向包

exclude_media

long[]

选填

媒体定向排除包

media和exclude_media只可选其一

media_source_type

int

选填

媒体包来源，0-不限，未指定，1-行业优质流量包，2-快手广告主自定义

默认为0

字段

类型

是否必填

说明

备注

min

int

必填

年龄最小限制

年龄区间最小为18岁

max

int

必填

年龄最大限制

年龄区间最大为55岁，且年龄最大限制须大于等于年龄最小限制

字段

特殊校验规则

url

1、不能为空，不能超过1000字符；

2、金融行业有白名单校验。