创建快手广告组
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/ad_unit/create
请求方式：POST
数据格式：JSON
请求参数 |
||||
字段 |
类型 |
是否必填 |
说明 |
备注 |
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 |
必填 |
定向数据 |
具体见下方表格 |
