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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手视频广告主ID

在获取access_token的时候返回

campaign_id

long

必填

快手信息流广告计划ID

unit_name

string

必填

快手广告组名称

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

template_id

long

选填

定向模板id

bid_type

int

必填

优化目标出价类型

1: CPM

2: CPC

10:OCPM

4: CPA只有计划类型为3，url_type=4才支持，而且ocpx_action_type只能为表单提交53)

use_app_market

int

优先从系统应用商店下载

下载模式

允许值：0，1；

1：优先从系统应用商店下载使用，默认0。

仅提升应用安装计划类型且选择的app为安卓才支持。

app_store

string[]

应用商店列表

华为：huawei,

OPPO：oppo

VIVO：vivo

小米：xiaomi

魅族：meizu

锤子：smartisan

只支持计划类型为 2 且应用是 Android 类型的快手推广

bid

long

出价

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

cpa_bid

long

出价

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

ocpx_action_type为180时，不得低于1元，不得高于3000元，

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

不得高于组预算

smart_bid

int

优先低成本出价(设置条件)

当 speed 等于 3 时可用

0：手动出价，1：自动出价

1、当 smart_bid 为 1 时，cpa_bid 或 deep_conversion_bid 都不能设置值

2、快享和联盟不支持优先低成本，直接报错

3、优先低成本的 bid_type 只支持OCPM

4、优先低成本 必须设置统一预算或分日预算

ocpx_action_type

int

优化目标

bid_type是OCPM时该字段必填

2：行为数（actionBar点击）

180：激活数

53：表单数

190: 付费

191：首日ROI

324：唤起应用（campaign_type=7+主站+加白）

348：有效线索

383: 授信

384: 完件

394：订单提交

（计划类型获取电商下单，非金牛）

396：注册（联盟暂不支持）

634: 预约表单

635: 预约跳转点击

715：微信复制优化目标

（campaign_type=5&bid_type=10）

716：多转化事件(campaign_type=5&bid_type=10&使用魔力建站&线索转化类组件>=2种)

717：广告观看次数（(campaign_type=2&bid_type=10&appi与转化追踪工具联调过或者该快手广告主的在相应事件的回传数）

731：广告观看5次

732：广告观看10次

733：广告观看20次

762：直播观看数;（快手小店直播推广&商品推广支持，计划type=14、13）

773：关键行为

774：7日ROI

192：直播推广ROI；小店直播推广&商品推广支持，计划type=14、13）

403：近似购买（小店直播推广&商品推广支持，计划type=14、13）

72：小店通商品和主页推广，转化目标“涨粉”

392：小店通商品推广，优化目标“转化数”，转化目标“商品访问”。

395：小店通商品和主页推广，转化目标“订单支付

需通过接口「rest/openapi/v1/ad_unit/ocpc/conversion_infos」获取是否可以选择「激活」、「表单转化」、「付费」、「授信」、「完件」的优化目标;

deep_conversion_type

int

深度转化目标

3:付费，7:次日留存，10:完件, 11:授信；13:添加购物车；14:提交订单；15:购买；44：有效线索；92:深度付费roi（付费-付费roi双，）

可通过下方深度转化信息查询接口获取当前账户可选的深度转化目标

roi_ratio

double

付费ROI系数

优化目标为「首日ROI」时必填：

ROI系数取值范围 ( 0,100 ] 最多支持到三位小数（如：0.066）    

deep_conversion_bid

long

深度转化目标出价

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

scene_id

int[]

必填

资源位置

1：快手优选广告位；

3：快手视频播放页广告-便利贴广告（不支持深度转化目标的优化）；

5：快手联盟广告

6：快手上下滑大屏广告；

7：快手信息流广告；

3、6、7可多选

unit_type

int

必填

创意制作方式

4: 自定义；5：程序化创意  7：程序化创意2.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不能同时传，均不能低于组出价

convert_id

int

可选

转化目标ID

可通过下方【转化目标查询接口】获得，不同计划类型需要对应各自的转化目标类型：

提升应用安装(campaign_type=2) - 安卓：convert_type:3、7 / IOS：convert_type:7

推广品牌活动(campaign_type=4) / 收集销售线索(campaign_type=5)：convert_type:1、2

url_type

int

url类型

当计划类型为3（获取电商下单）时必填：

1 - 淘宝商品短链

2 - 淘宝商品itemID

4 - 金牛电商

web_uri_type

int

url类型

当计划类型为5（收集销售线索）&使用建站时必填：需使用魔力建站

不传默认1，2：落地页

url

string

投放链接

当计划类型是3/4/5时必填；

长度不超过1000字符；

计划类型是3（获取电商下单）：金牛商品ID（必须为数字）

计划类型是4（推广品牌活动）：落地页URL；

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

计划类型是5（收集销售线索）：建站ID，通过/rest/openapi/v2/lp/page/list获取

schema_uri

string

可选

调起链接

提升应用活跃营销目标的调起链接

app_id

long

应用ID

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

为计划类型9时且detail_unit_type为0、2时必填

show_mode

int

必填

创意展现方式

1 - 轮播

2 - 优选

speed

int

必填

投放方式

1 - 加速投放

2 - 平滑投放

3-优先低成本（投放时间范围只可为全天；预算不可为不限或空）

site_type

int

加白

预约快手广告

1:IOS预约

缺省为不传或传0

gift_data

struct

加白

游戏礼包码

"gift_data": {}，仅支持计划类型为 2

video_landing_page

Boolean

是否使用落地页前置功能

true: 使用 false：不使用，

不填使用系统默认值

（只支持双feed流，推广品牌活动-落地页url填写、获取电商下单-淘客短链url填写、获取电商下单-金牛活动页、获取销售线、获取销售线索）

auto_target

boolean

选填

智能定向

若开启智能定向，定向部分仅保留地域+年龄+性别+排除人群+系统纬度的定向，其他定向纬度暂不支持（报错处理）

true表示开启，false表示未开启

smart_cover

boolean

unit_type=7选填

程序化创意2.0智能抽帧

是否开启智能抽帧

asset_mining

boolean

unit_type=7选填

程序化创意2.0素材挖掘

是否开启历史素材挖掘

fiction_id

long

选填

小说ID，仅支持“提升应用安装”、“收集销售线索”以及“提高应用活跃”三种计划类型，且一旦绑定，不可修改

此参数仅是绑定小说，并非自动关联小说生成的落地页，如需推广小说生成的落地页，请使用小说ID获取其生成的建站落地页后将落地页ID一并传入即可（落地页ID传参与之前建站落地页ID字段一致）

item_id

long

选填

电商关联Id (小店通商品推广，计划type=13)

1. merchantItemType为0时填写小店商品id

2. merchantItemType为2时不用填写，系统补充

merchant_item_put_type

int

选填

快手电商广告投放类型（小店商品推广，计划type=13）

0: 商品

2: 个人主页

dpa_unit_param

struct

选填

dpa相关商品信息

当计划类型为sdpa时必填

target

struct

必填

定向数据

具体见下方表格