王尘宇

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手广告组ID

unit_name

string

可选

快手广告组名称

不能修改为空，长度为1-100个字符，组名称不能重复

bid

long

可选

出价

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

cpa_bid

long

可选

出价

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

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

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

不得高于组预算

deep_conversion_bid

long

可选

深度转化目标出价

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

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不能同时传，均不能低于该广告组出价

url

string

可选

投放链接

当快手推广计划类型是5时必填；

长度不超过1000字符；

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

app_id

long

可选

应用ID

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

show_mode

int

可选

创意展现方式

1 - 轮播

2 - 优选

speed

int

可选

投放方式

1 - 快速投放

2 - 平滑投放

target

struct

可选

定向数据

具体见下方表格

target

字段

类型

是否必填

说明

备注

region

long[]

可选

地域

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

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

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

age

struct

可选

自定义年龄段

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

与ages_range不能同时传

ages_range

int[]

可选

固定年龄段

与age不能同时传；

【0：表示0-11岁】

【12：表示12-17岁】

【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有交集