3.2 创建快手广告组
请求接口：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
必填
定向数据
具体见下方表格
本文标题：快手广告管理平台Marketing API开发文档《NO.3》
本文链接：https://www.eatui.cn/xinxiliu/18084.html
