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

请求参数

字段

类型

是否必填

说明

备注

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

必填

定向数据

具体见下方表格

target

字段

类型

是否必填

说明

备注

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

age

字段

类型

是否必填

说明

备注

min

int

必填

年龄最小限制

年龄区间最小为18岁

max

int

必填

年龄最大限制

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

特殊校验规则

字段

特殊校验规则

url

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

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

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

unit_id

long

快手广告组ID