智能托管创建及更新接口

创建接口：https://ad.e.kuaishou.com/rest/openapi/gw/dsp/v1/hosting/project/create 更新接口：https://ad.e.kuaishou.com/rest/openapi/gw/dsp/v1/hosting/project/update 创建和更新使用的参数结构完全一样

请求参数

请求参数	类型	含义	使用说明
advertiser_id	Long	广告主accountId	必填
name	String	项目名称	必填，长度不超过90字符
hosting_scene	Integer	营销场景	必填，取值见枚举说明【hosting_scene】
campaign_type	Integer	计划类型	必填，取值见枚举说明【campaign_type】
app_id	Long	应用id	当campaign_type=2时必填；当campaign_type=5时只能填0
web_uri	String	应用下载地址/落地页地址	当hosting_scene=0,5时：当campaign_type=2时，代表应用下载链接，取app_id对应的链接，无需传入；当campaign_type=5时，代表落地页地址，此时联动web_uri_type，当web_uri_type=1时代表用户自有落地页，需要传入http或https开头的链接，当web_uri_type=2时使用自建站页面，此时联动site_id，要求site_id非0，此时本字段不需要传入，当web_uri_type=0此时不合法。当campaign_type=7时必填，代表H5链接链接，需要传入http或https开头的链接，当用户调起应用失败或未填调起链接时打开H5链接；当hosting_scene=1时：当campaign_type=2时，代表应用下载链接，取app_id对应的链接，无需传入；当campaign_type=5时，本字段必须保持为0。原因，小说测书场景的落地页跟随每本小说变化，不需要本字段。
schema_uri	String	直达链接/调起链接	当campaign_type=2时，代表"开启直达链接，点击直接唤起APP"。当campaign_type=7时，代表调起链接，需要传入http或https开头的链接，填写后优先打开调起链接，可调起应用内详情页，不填(需要加白，未在白名单则必填)则优先打开H5链接(web_uri)；
use_app_market	Boolean	使用开启应用商店直投	当campaign_type=2时，只有安卓应用才可以开启本字段；当campaign_type=5时，本字段不做检查，可用。本字段联动app_store
app_store	String[]	应用商店直投列表	当use_app_market=false时本数组需要为空；当use_app_market=true时，本字段一定不能为空，且有效值需要在app_store的枚举内
sticker_styles	Integer[]	贴纸id集合	当hosting_scene=0,5时可用，hosting_scene=1不可用，需要保持为空数组。本字段的合法取值见sticker_styles说明。本字段联动cover_slogans，需同时保持为空或者不空。本数组长度最大为6个。
cover_slogans	String[]	贴纸广告语集合	当hosting_scene=0,5时可用，hosting_scene=1不可用，需要保持为空数组。本字段联动cover_slogans，需同时保持为空或者不空。本数组长度最大为12个。本字段每个元素均不能为空，不可以空格开头或结尾、不能包括换行和连续空格，长度最多14字符，且若使用了动态词包必须是可识别的。
action_bar	String	行动号召按钮	当hosting_scene=0,5时可用，hosting_scene=1不可用。本字段可用值请参考开放平台拉取行动号召按钮的接口。
captions	String[]	作品广告语集合	当hosting_scene=0,5时可用，hosting_scene=1不可用。本数组长度最小为1，最大为12。本字段每个元素均不能为空，不可以空格开头或结尾、不能包括换行和连续空格，长度最多30字符，且若使用了动态词包必须是可识别的。
click_url	String	第三方点击检测链接	当hosting_scene=0,5时可用，hosting_scene=1不可用。本字段非空的时候，必须以http或https开头。满足以下任一条件时本字段必填：1、优化目标为激活2、当campaign_type=2时，优化目标为注册、付费、完件、授信但是，如果此时选择的应用app_id接入了快手sdk，则可以不填写。
ad_photo_played_t3s_url	String	3s播放监测链接	使用本功能需要添加功能白名单。本字段不能和click_url字段相同。
actionbar_click_url	String	第三方actionbar点击检测链接	当hosting_scene=0,5时可用，hosting_scene=1不可用。使用本功能需要添加功能白名单。本字段不能和click_url字段相同。本字段非空的时候，click_url必须非空。
auto_create_photo	Boolean	自动生成视频	仅当hosting_scene=1时可用
begin_time	Long	投放开始时间	必填，13位毫秒时间戳，不可小于当前时间往前推一个小时
end_time	Long	投放结束时间	必填，13位毫秒时间戳，0=长期投放，非0代表截止投放结束时间
schedule	String	投放排期	投放排期分为两种1、不设定排期，此时本字段请填写'[]'，即空数组2、设定排期，此时数组长度必须为7，且排列顺序是从周一到周日。每个数组元素为一维数组，取值为0,23，设定了哪个就代表投放小时。举例：投放周一的8、9、16点以及周三的21、22点，其他时间不投传值：'[8,9,16,[],21,22,[],[],[],[]]'(注意本字段是一个二维数组格式的string)
day_budget	Long	每日预算	必填，单位为厘，不小于500元，不超过1亿
ocpx_action_type	Integer	优化目标	必填，可用优化目标列表可从接口拉取，见https://developers.e.kuaishou.com/docs?docType=DSP&documentId=2187
cpa_bid	Long	优化目标出价	当hosting_scene=5不填或填0，当hosting_scene!=5规则如下：当ocpx_action_type为roi类目标时必填。单位为厘。需要满足优化目标的出价规范，参考普通创建。
deep_conversion_type	Integer	深度优化目标	当ocpx_action_type支持深度目标时可用，可用深度目标列表可从接口拉取，见https://developers.e.kuaishou.com/docs?docType=DSP&documentId=1933
deep_conversion_bid	Long	深度优化目标出价	当deep_conversion_type不为0且不为roi类目标时必填。单位为厘。需要满足深度优化目标的出价规范，参考普通创编。
site_id	Long	建站页面id	当hosting_scene=0,5时：当campaign_type=2时，代表应用下载中间页，此时页面包括的app_id必须和选定的应用的app_id保持一致。当campaign_type=5时，代表使用建站落地页作为落地页地址，此时联动web_uri_type，web_uri_type必须是2，此时web_uri字段可不填。当hosting_scene=1时：当campaign_type=2时，代表应用下载中间页，此时页面包括的app_id必须和选定的应用的app_id保持一致。当campaign_type=5时，本字段不可用，需要保持为0.
smart_cover	Boolean	抽帧	当hosting_scene=0,5时：当smart_cover=false，即不开启抽帧，此时photo_infos属性的image_token如果传入则用传入值获取封面，否则按照首帧获取封面图。当smart_cover=true时，开启抽帧，此时photo_infos属性的image_token不需要传入。当hosting_scene=1时：本字段只能为false
roi_ratio	Double	roi系数	当hosting_scene=5不填或填0，当hosting_scene!=5规则如下：当ocpx_action_type或者deep_conversion_type为roi类目标时，本字段必填。有效范围为(0,100]。本字段如果代表的ocpx_action_type对应的系数，则cpa_bid需要保持为0.本字段如果代表的deep_conversion_type对应的系数，则deep_conversion_bid需要保持为0.
consult_id	Long	咨询组件id	仅当常规推广、最大转化（hosting_scene=0,5）下的收集销售线索（campaign_type=5）使用了建站落地页（site_id!=0）时可用。
asset_mining	Boolean	素材挖掘	必填注意本属性可有关闭改为开启，但不可由开启改为关闭。
fiction_id	Long	小说id	hosting_scene=1时本字段不可用，需要传0.hosting_scene=0时，代表绑定的小说id。本字段需要添加白名单，且如果在强制绑定白名单里，就必须绑定小说
web_uri_type	Integer	落地页类型	本属性的有效取值见枚举web_uri_type说明。当hosting_scene=0,5时：当campaign_type=2时本属性需要设定为0；当campaign_type=5时，web_uri_type=1代表自有落地页，此时site_id需要为0，且web_uri需要传入；web_uri_type=2代表建站落地页，此时site_id必须非0，web_uri不需要传入；web_uri_type=3代表程序化落地页，此时group_id需要传入，web_uri不需要传入。当hosting_scene=1时，本属性不可设定
group_id	Long	程序化落地页id	仅当hosting_scene=0,5，且campaign_type=5，且web_uri_type=3时，可传入本属性，须传入有效的group_id。其他场景下传0即可。
scene_ids	Integer[]	投放场景	本属性的有效取值见枚举scene_id说明。可以支持的场景位组合，仅1、6、10、6,10、1, 10、24、6,24、10、24、6、10、24当scene_ids包含10时：hosting_scene必须为0或者1，且ocpx_action_type不可为774，且deep_conversion_type不可为8、116、117、118、119、137、109、43
ad_dsp_target	结构体json	定向属性	必填，属性见下文具体说明
fiction_infos	结构体数组	小说属性	当hosting_scene=0,5时需要保持为空数组；当hosting_scene=1时必填。属性见下文具体说明
photo_infos	结构体数组	视频信息	当hosting_scene=0,5时必填；当hosting_scene=1时需要保持为空数组。属性见下文具体说明
pic_infos	结构体数组	图片信息	非必传，仅在hosting_scene=0, 且scene_ids包含联盟场景10时，可传属性见下文具体说明
name_rule	结构体json	命名规则	格式如下{"rule_enable": false, //是否开启命名规则"campaign_name_rule": "",//计划命名规则"unit_name_rule": "",//单元命名规则"creative_name_rule": ""//创意命名规则}当rule_enable=false时，具体规则项都不可传入；当rule_enable=true时，规则项必须有一个为非空值。每项命名规则的长度，不能超过100字符，如果包括了宏变量，则取宏变量最长的占位长度。命名规则的可用宏变量可见说明“name_rule宏变量” 本属性可以更新，但只能由关闭改为开启，或者在开启状态下修改具体项，不可由开启改为关闭。
project_id	Long	项目id	注意，本属性在create时可不传或者传0，传入非0值也是不识别的；在update时，本属性必填。
bid_type	Integer	出价方式	10=常规推广（成本优先）、小说测书（选填）12=常规推广（跑量优先）、最大转化（必填）
constraint_action_type	Integer	浅层约束目标	可选值见constraint_action_type枚举值，仅跑量优先下可用
constraint_cpa	Long	浅层成本约束	当constraint_action_type为非0时必填。单位为厘。需要满足浅层约束目标的出价规范，参考普通创建。
intelli_budget	Boolean	智能预算优化开关	仅跑量优先场景(hosting_scene=0&bid_type=12)且为白名单用户时可用、当intelli_budget=true，即开启智能预算优化、当intelli_budget=false时，即关闭智能预算优化。
dpa_sub_type	Integer	关联商品库类型	当campaign.type=5且在商品库白名单中时可用。其中枚举为2：SDPA单商品
dpa_library_id	Long	关联商品库ID
dpa_outer_id	String	关联商品ID	当dpa_sub_type = 2时必填
enhance_conversion_type	Integer	增强目标	仅当优化目标=激活/表单，深度优化目标=自然日次日留存时，支持设定改属性。目前仅支持“自然日七日留存”，即enhance_conversion_type=8
package_id	Long	选填	新版应用中心，应用包ID；使用新版应用，该字段必填，老版本非必填

name_rule宏变量

宏	使用范围	使用说明	示例
日期	计划/广告组/创意	格式为年月日，字数占位8，未选择日期情况下，广告组名字默认追究_日期	20210101
时间	计划/广告组/创意	格式为小时:分钟，字数占位5	12:00
序号	广告组/创意	自增序号，字数占位4，天级别自增，删除仍保持序号占位，下一次新建继续增加序号。未选择序号情况下，广告组名字默认追究_序号，序号为天级别计数，启用后按照当天总数计算。	1、2、3...
书名	广告组/创意	字数占位30，仅绑定小说时生效，非生效场景替换成空

ad_dsp_target属性

属性	类型	含义	使用说明
age	结构体数组	投放年龄区间	1、不设定年龄则传入[] 2、设定为自定义年龄区间，则只能传入一个值，最小为18，最大为55，如 { "min": 18, "max": 55 }3、当设定的年龄区间不止一个，则只能在如下区间选择18,23、24,30、31,40、41,49、50,100，如 { "min": 18, "max": 23 }, { "min": 41, "max": 49 }
population	Long数组	定向人群id集合	不设定，用[]代表；设定定向人群时，定向id需要是可识别的。定向人群id集合不能超过100个。
exclude_population	Long数组	排除人群id集合	不设定，用[]代表。设定时，排除id需要是可识别的。排除人群id集合不能超过100个。
paid_audience	Long数组	付费人群id集合	不设定，用[]代表。设定时，id需要是可识别的。数组个数不能超过100个。另外，population、exclude_population、paid_audience有联合检查规则，如不同存在相同值、定向人群population和paid_audience不可同时设定等。
gender	字符串	性别	""代表不限性别。"F"代表女性、"M"代表男性
region_ids	Long数组	定向地域	不限定地域用[]代表；设定时id需要为可识别值。仅支持设定"指定地区"。若需要设定"城市等级"，请不要传入此字段，并使用region_category_ids
region_category_ids	String数组	定向地域	设定"城市等级"时，使用此字段。不限定地域用[]代表；设定时id需要为可识别值
region_type	Integer	地域类型	见region_type枚举说明
user_type	枚举	定向地域的人群类型	见user_type枚举说明
intelli_extend（新、支持编辑）	json	智能扩量	格式如下 "no_age_break": false,//是否允许打破年龄带限制 "no_gender_break": false,//是否允许打破性别限制 "no_area_break": false,//是否允许打破地域限制 "is_open": true //是否开启智能扩量，本字段只能是true，可不传，传入false也会被修改为true}
platform	json	定向平台	本属性需要和appId的平台一致；如果是落地页，且落地页内包括了下载组件，则需要和下载组件的平台一致，如果是快应用的落地页，则需要为安卓7.0及以上。合法取值有三种，不限定平台，用{}代表；限定安卓平台：{ "android": { "min": 3 }}注意安卓平台的最小取值为3，最大取值为10、限定ios平台：{ "ios": { "min": 6 }}注意ios平台的最小取值是6，最大取值为14.注意ios和android两个key只能选择一个传入，不能同时传入。
filter_converted_level	枚举	过滤已转化人群	见枚举说明filter_converted_level；注意当campaign!=2时，filter_converted_level不可以取5即过滤app。filter_converted_level=6需加白使用仅支持提升应用安装和收集销售线索
filter_time_range	枚举	用户的转化时间范围	需加白使用，见枚举说明filter_time_range，提升应用安装和收集销售线索下filter_converted_level!=0时可用枚举值1，2
app_interest_ids	String数组	定向属性APP行为-按APP分类	仅限提升应用活跃下可用，与按APP名称互斥，即app_interest_ids与package_name不可同时为非空
package_name	String数组	定向属性APP行为-按APP名称	仅限提升应用活跃下可用，与按APP分类互斥，即app_interest_ids与package_name不可同时为非空
device_brand_ids	Long数组	定向属性设备品牌ids	在提升应用安装和提升应用活跃下当目标应用(app_id)为安卓平台应用时可用在收集销售线索时与定向平台(platform)联动，当不限定平台或限定ios平台时可以选择苹果(id=1)和其他安卓品牌(id=2、3...)如：1,2，当限定为安卓平台时不可选择设配品牌为苹果(id=1)
device_brand	String数组	定向属性设备品牌名称	定向属性设备品牌ids对应品牌名称，如："苹果",""VIVO"。与device_brand_ids联动，device_brand_ids非空信任device_brand_ids参数，device_brand_ids为空信任device_brand参数值
ip_type	Integer	地域IP类型	白名单可用，0-默认IP、1-广协IP

photo_infos属性

本属性为一个数组，以下是数组每个元素的属性说明

属性	类型	含义	使用说明
photo_id	Long	视频id	必须是有效的视频id
photo_orientation	Integer	横版或者竖版	1=竖版、2=横版
cover_image_token	String	封面token	需要是用户上传封面后得到的有效token。注意，本字段联动smart_cover。

pic_infos属性

本属性为一个数组，以下是数组每个元素的属性说明

属性	类型	含义	使用说明
image_token	String	图片token	必须是有效横竖版图片的token，必传
pic_name	String	图片名称	展示字段，无需上传
pic_type	Integer	图片类型	展示字段，无需上传
pic_url	String	图片链接	展示字段，无需上传
pic_id	Long	图片加密id	展示字段，无需上传

fiction_infos属性

本属性为一个数组，以下是数组每个元素的属性说明

属性	类型	含义	使用说明
fiction_id	long	小说id	必须为有效值；不可重复
photo_infos	json数组	视频信息	见photo_infos属性说明
smart_cover	boolean	抽帧	boolean=true时，photo_infos内的cover_image_token可不传，传了也会忽略。boolean=false时，photo_infos内的视频封面，如果cover_image_token传了则用cover_image_token的值，否则使用首帧。
action_bar	字符串	行动号召按钮	见hosting_scene=0时对应字段的说明
captions	字符串数组	作品广告语	见hosting_scene=0时对应字段的说明
click_url	字符串	第三方点击监测链接	见hosting_scene=0时对应字段的说明
actionbar_click_url	字符串	第三方actionbar点击监测链接	见hosting_scene=0时对应字段的说明
web_uri	字符串	落地页链接	联动web_uri_type和site_id，见web_uri_type说明
site_id	long	建站页面id	联动web_uri_type和web_uri，见web_uri_type说明
web_uri_type	int枚举	落地页链接类型	本属性已经是在hosting_scene=1的场景下了，此时当campaign_type=2时，web_uri_type、site_id和web_uri无需使用，保持默认值即可；当campaign_type=5时，web_uri_type=1代表自有落地页，此时site_id=0，web_uri需要填入有效值；当web_uri_type=2时代表建站落地页，此时site_id!=0，web_uri不需要传值。

智能托管创建及更新接口

请求参数#

请求参数

返回响应

请求参数