advertiser_id

long

必填

快手广告主 ID

在获取 access_token 的时候返回

campaign_id

long

必填

快手广告计划 ID

unit_name

string

必填

快手广告组名称

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

put_status

int

选填

快手广告组的投放状态

1：快手广告组投放中；2：快手广告组暂停投放；当不传或为 null 时，会默认填充 1

bid_type

int

必填

优化目标出价类型

2：CPC（计划类型为粉丝直播推广、DPA不支持，计划出价为MCB不支持；快手广告组选择开屏不支持；快手搜索广告需要添加白名单才可支持）；10：OCPM；12:MCB转化（当计划bid_type=1时，组层级bid_type传12）

bid

long

选填

出价

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

cpa_bid

long

选填

出价

bid_type 是 OCPM 时该字段必填，单位：厘，ocpx_action_type 为 2 时，不得低于 0.1 元，不得高于 10 元；ocpx_action_type 为 180 时，不得低于 1 元，不得高于 3000 元，ocpx_action_type 为 53 时，不得低于 5 元，不得高于 3000 元；不得高于组预算

ocpx_action_type

int

选填

优化目标

bid_type 是 OCPM 时该字段必填，需通过接口「rest/openapi/gw/dsp/v1/ocpx/ocpxTypes」获取可以选择的优化目标；2：行为数（actionBar 点击）；180：激活数；53：表单数；109：电话卡激活；137：量房；190： 付费；191：首日 ROI；324：唤起应用（campaign_type=7+主站+加白）；348：有效线索；383: 授信；384: 完件；394：订单提交（计划类型获取电商下单，非金牛）；396：注册（联盟暂不支持）；715：微信复制优化目标（campaign_type=5&bid_type=10）；716：多转化事件(campaign_type=5&bid_type=10&使用魔力建站&线索转化类组件>=2 种)；717：快手广告观看次数(campaign_type=2&bid_type=10&app与转化追踪工具联调过或者该快手广告主的在相应事件的回传数>=1）；731：快手广告观看 5 次；732：快手广告观看 10 次；733：快手广告观看 20 次；773：关键行为；774：7 日 ROI；72：小店通商品和主页快手广告推广，转化目标“涨粉”；739:7 日付费次数；392：小店通商品推广，优化目标“转化数”，转化目标“商品访问”；395：小店通商品和主页推广，转化目标“订单支付”；62：直播观看数,（小店直播推广&商品推广支持，计划 type=14、13）；192：快手广告直播推广 ROI；(小店直播推广&商品推广支持，计划 type=14、13）；634：预约表单；635：预约点击跳转。需通过接口「获取可选的深度转化类型」，接口 is_order_paied 字段返回值为 1 才可以使用；810:激活付费；346:自然日次日留存

deep_conversion_type

int

选填

深度转化目标

通过接口「/rest/openapi/gw/dsp/v1/ocpx/deepTypes」获取可以选择深度转化目标；3:付费，7:次日留存，10:完件, 11:授信；13:添加购物车；14:提交订单；15:购买；44：有效线索；92：付费 roi；181：激活后24H次日留存。

enhance_conversion_type

int

选填

增强目标

8：7日留存

roi_ratio

double

选填

付费 ROI 系数

优化目标为「首日 ROI、7日ROI出价」时必填：ROI 系数取值范围 ( 0,100 ] 支持到三位小数（如：0.066）

deep_conversion_bid

long

选填

深度转化目标出价

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

scene_id

int[]

必填

资源位置

1：选快手广告位（当快手广告账户在联盟优选白名单中且 campaign_type=2/3/5/7 时为主站&联盟优选广告位 ）；5：联盟广告（对应DSP后台unit层级选择联盟广告位）；6：上下滑大屏广告（计划 campaignType=16 粉丝直播推广时，支持填写 6）；7: 双列快手信息流广告（加白可用）；10：联盟场景;当账户在联盟优选白名单中且 campaign_type = 2/3/5/7，可传 10；当快手广告账户不在联盟优选白名单中或 campaign_type 不等于 2/3/5/7 时，不可传 10；（对应DSP后台创意层级选择联盟广告位）；24:激励视频（需要加白后可选）；27：快手开屏广告位（白名单功能）；39：快手搜索广告

unit_type

int

必填

创意制作方式

3：DPA 自定义创意（仅在计划类型为商品库推广下使用）；4: 常规自定义创意； 7：程序化创意 2.0

begin_time

string

必填

快手广告投放开始时间

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

end_time

string

选填

快手广告投放结束时间

格式为 yyyy-MM-dd，不传值表示从今天开始长期投放，传值表示设置开始时间和结束时间，且快手广告投放结束时间需大于等于快手广告投放开始时间，开屏如果选择按开始时间和结束时间投放，时间(end_time - begin_time)必须超过三天

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 不能同时传，均不能低于该计划下任一快手广告组出价，优先级高于day_budget

convert_id

int

选填

转化目标 ID

可通接口【/rest/openapi/v1/tool/convert/list】获得，不同计划类型需要对应各自的转化目标类型：提升应用安装(campaign_type=2) - 安卓：convert_type:3、7 / IOS：convert_type:7；快手广告推广品牌活动(campaign_type=4) / 收集销售线索(campaign_type=5)：convert_type:1、2 收集销售线索营销目标下，建站落地页程序化落地页不支持convertId，自有落地页仅支持convert_type=1的场景

url_type

int

选填

url 类型

当计划类型为获取电商下单（campaign.type=3）时必填，其它场景下无效；

3 - 手淘落地页（深度唤醒手机某宝，scene_id为5时联盟场景不可用）

web_uri_type

int

选填

url 类型

当计划类型为收集销售线索、提升应用活跃（campaign.type = 5/7 ）且使用建站落地页时必填；1：快手广告主自有链接，默认填充值； 2：建站落地页，此时siteId_id 需要填充；3：程序化落地页，此时group_id需要填充（仅收集营销线索下可用） ；4：微信小程序调起链接（仅收集营销线索下且scene_id包含5可用）。

url

string

选填

快手广告投放链接

长度不超过 1000 字符；计划类型是获取电商下单（campaign.type=3)，url_type = 3 时表示手淘落地页；计划类型是 4（快手广告推广品牌活动）：落地页 URL；web_uri_type = 1 时表示客户自有链接必填；web_uri_type = 4 时表示小程序的落地页；「房地产」「家装建材」「招商加盟」三个二级行业【收集销售线索】目标下隐藏客户自有链接填写入口。

site_id

long

选填

建站ID/下载中间页ID

当 web_uri_type = 2 时表示建站 ID，必须为数字，通过「/rest/openapi/v2/lp/page/list」 获取。计划类型是2（提升应用安装）且关联应用为安卓时，表示安卓下载中间页ID，通过「/rest/openapi/v2/lp/page/list」 获取 "view_comps = 7" 的建站ID。

group_id

long

选填

程序化落地页ID

web_uri_type = 3 时表示程序化落地页ID，必须为数字，通过「/rest/openapi/gw/magicsite/v1/group/list」获取；

schema_uri

string

必填

调起链接

提升应用活跃营销目标的调起链接；应用快手广告推广下在已经安装 app 的用户手机上可以拉起 app（需要运营加白），快手开屏广告如果营销目标是应用活跃，调起链接必须在品牌开屏白名单中；当 web_uri_type = 4 时，该字段必填，表示带归因参数的小程序启动页面链接，当campaign.type=5时，白名单用户可填。campaign.type=9 时，若该字段非空，使用该链接唤起应用，否者使用商品上的链接直达商品

schema_id

String

选填

微信小程序ID

收集营销线索下，web_uri_type = 4时生效，表示微信小程序ID

app_id

long

必填

应用 ID

当计划类型为 提升应用活跃/提升应用安装/商品库推广（campaign.type = 2/7/9） 时必填，可通过应用列表接口「/rest/openapi/v2/file/ad/app/list」获取应用 ID；当计划类型为粉丝直播推广（campaign.type = 16），且组件类型为小铃铛关联了应用时必填。

app_download_type

int

选填

应用下载方式

0 - 直接下载；1 - 落地页下载；仅在提升应用活跃（默认是直接下载）、提升应用安装（默认是落地页下载）下白名单生效。

download_page_url

string

选填

自定义落地页URL

选择落地页下载方式时的自定义落地页URL，仅在提升应用活跃和提升应用安装下生效，site_id 优先级高于此字段，白名单功能

use_app_market

int

选填

优先从系统应用商店下载

0：不从应用商店下载；1：先从应用商店下载。【填充为1的前提：提升应用活跃、提升应用安装计划类型且选择的应用为安卓。收集营销线索计划类型且选择的建站落地页关联了安卓APP】

app_store

string[]

选填

应用商店列表

【仅当use_app_market=1时生效】

show_mode

int

选填

创意展现方式

1 - 轮播；2 - 优选（默认）

site_type

int

加白

预约快手广告

1 - IOS预约；2 - ANDROID 预约；

【仅在计划类型为收集营销线索，web_uri_type = 2 时生效】

smart_cover

boolean

unit_type=7 选填

程序化创意 2.0 智能抽帧

是否开启智能抽帧

asset_mining

boolean

unit_type=7 选填

程序化创意 2.0 素材挖掘

是否开启历史素材挖掘

consult_id

long

选填:从工具-获取可选咨询组件

咨询组件 id

1、仅可被用于线索类计划下的 unit；2、仅当落地页使用了建站落地页或者建站程序化落地页时可使用；3、注意本字段不可被更新；4、本属性不可与附加表单组件(component_id)同时使用；通过「/rest/openapi/v2/lp/consult/list」接口获取

adv_card_option

int

选填

高级创意开关

0：关闭 1:开启

adv_card_list

long[]

选填

绑定卡片 id

card_type=100 为 1 个；card_type=101 为 3 个；card_type=102 为 3 个；card_type=103 为 1 个；通过接口「/rest/openapi/v1/asset/adv_card/list」获取

playable_id

Long

选填

试玩 ID

可选字段，开启试玩时存在，否则不存在。当用户上传试玩素材成功时返回，用于之后对于快手广告组中试玩创意的编辑操作。通过接口「 /rest/openapi/gw/dsp/v1/playable/list 」 获取

play_button

String

选填

试玩按钮文字内容

开启试玩时存在，否则不存在，示例按钮内容如下：1：立即试玩；2：试玩一下；3：立即体验；4：免装试玩；5：免装体验。启用试玩时：默认“立即试玩”，未启用试玩时：内容为空。通过接口「/rest/openapi/gw/dsp/v1/playable/play_buttons」获取

dpa_unit_param

struct

选填

DPA 相关商品信息

当计划类型为商品库推广时必填。

jingle_bell_id

long

选填

小铃铛组件id

计划 campaignType=16 粉丝直播推广时必填写

live_user_id

long

选填

主播id

计划 campaignType=16 粉丝直播推广时必填写, 计划 campaignType=30 短剧推广时，必填，值为短剧作者ID

conversion_type

int

选填

转化途径

计划 campaignType=16 粉丝直播推广时必填写 6

extend_search

boolean

选填

智能扩词开启状态

false：关闭，true：开启，不填默认为false

custom_mini_app_data

struct

选填

快手广告推广小程序营销目标小程序信息

计划 campaignType=19 推广快手小程序时必填，具体见下方表格。 具体见下方表格

target

struct

必填

定向数据

具体见下方表格

template_id

long

选填

定向模板 id

此字段关联到定向信息后，target 字段失效。会将关联的定向信息填充到快手广告组中。

outer_loop_native

int

选填

是否开启原生

1开启，0关闭 不填则默认为0，投放快手信息流广告时（ad_type=0或默认不填，scene_id包含1快手广告位、6上下滑大屏广告、7双列快手信息流广告），当campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序、30快手号-短剧推广时，可开启原生投放。注：投放快手信息流广告且升级白名单账户必选 outer_loop_native = 1，否则会报错

quick_search

int

选填

搜索快投开关

0：不开启（默认填充）；1：开启搜索快投

target_explore

int

选填

搜索人群探索

0：不开启；1：开启；开启后系统将基于用户搜索行为探索定向人群以外的更多优质人群，仅在 quick_search = 1时生效

negative_word_param

struct

选填

快手搜索广告否词

设置否词必填

package_id

long

必填

新版应用中心，应用包ID

使用新版应用中心投放，该字段必填；老版本应用非必填 获取母包接口文档 获取分包接口文档

series_id

long

选填

短剧id

当计划 campaignType=30 短剧推广时，必填

episode_id

long

选填

短剧下剧集id

当计划 campaignType=30 短剧推广时，必填

series_card_type

int

选填

是否使用短剧卡片

0关闭，1开启，默认关闭，仅在计划 campaignType=30快手号-短剧推广时支持开启使用短剧卡片

series_card_info

struct

选填

短剧卡片信息

开启短剧卡片时，必填，具体见下方表格

series_pay_template_id

long

选填

短剧付费模板id

仅在计划 campaignType=30快手号-短剧推广时支持使用，需要跟付费模式一起使用

series_pay_mode

int

选填

短剧付费模式

仅在计划 campaignType=30快手号-短剧推广时，需要跟付费模板一起使用，1-打包；2-虚拟币

u_link

String

选填

Universal Link 链接

仅在计划 campaignType=7 提升应用活跃时使用，输入后IOS将优先调起该链接，不超过2000字符