快手广告：创建程序化创意

疑难解答

快手广告：创建程序化创意

发布时间：2024-01-05浏览次数：32

创建程序化创意

请求方式：POST

数据格式：JSON

请求参数

字段	类型	是否必填	说明	备注
advertiser_id	long	必填	快手广告主 ID	在获取 access_token 的时候返回
unit_id	long	必填	快手广告组 ID	一个组下只能有一个程序化创意，这个快手广告组的 unit_type 为 7 能创建程序化创意
package_name	string	必填	程序化创意名称	不能为空，1-100 字符
sticker_styles	int[]	选填	封面贴纸	（快手搜索广告支持）如果使用封面贴纸 sticker_Styles 和 cover_slogans 必须同时传值，可选择 6 个
cover_slogans	string[]	选填	封面广告语	（快手搜索广告支持） 0-14 字符，可选择 6 个（每个中文和英文字符都算一个字符）
action_bar	string	必填	行动号召按钮
captions	string[]	必填	作品广告语	每个不超过 30 个字符，英文字符两个算一个字符，可传 3 个
click_url	string	选填	第三方点击检测链接	不能超过 1024 字符 ocpx_action_type 是 180 并且应用没有接入 sdk，监测链接必填；计划 type 是 2（快手广告推广应用安装），ocpx_action_type 是注册（396）、付费（190）、完件（384）、授信（383），并且没有接入 sdk，监测链接必填
actionbar_click_url	string	选填	第三方 ActionBar 点击监控链接，命中有效触点白名单表示有效触点监测链接（限：快手广告主站/极速版场景）	部分客户使用 actionbar_click_url 不为空时，click_url 必填，不能超过 1024 字符
ad_photo_played_t3s_url	string	选填	第三方有效播放监测链接	白名单功能，且当快手广告组 scene_id 为 27（开屏）时不支持该检测链接；与 impression_url 不可同时使用
creative_category	int	金融，教育，游戏，小说，电商如上行业必填	创意分类	由创意分类查询接口获得；必须是叶子结点；与创意标签同时传或同时不传可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填
creative_tag	string[]	选创意分类必填	创意标签	与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符
photo_list	struct[]	选填	素材列表	新创建程序化创意请使用此参数，支持 10 组素材(传递后将忽略 horizontal_photo_ids,vertical_photo_ids,cover_image_tokens，7.15 日后老字段下线)
pic_list	string[]	选填	联盟图片（横版/竖版）	需要传入image_token列表，image_token通过上传图片接口获取
new_expose_tag	struct[]	选填	快手广告标签 2 期	按照相关格式传递两个推荐理由举例{“text”:"工厂直发"},{"text":"限时专享"}
material_intelligent_optimize	int	选填	素材智能优化开关	0-关闭，1-开启，不传默认关闭。仅白名单用户支持使用。
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，否则会报错
kol_user_type	int	选填	原生达人用户类型	1普通快手号原生，2服务号原生，3聚星达人（需加白使用），当outer_loop_native=1时此项必填。
kol_user_id	long	选填	原生投放目标达人ID	开启原生场景下必传，即当outer_loop_native=1时此项必填。计划 campaignType=30 短剧推广时，值为短剧作者ID
recommendation	string	选填	原生plc自定义文案	开启原生时可用

photo_list

字段	类型	是否必填	说明	备注
photo_id	long	必填	视频 ID
cover_image_token	string	选填	封面图片 token	通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致，使用智能抽帧时不需要传递。
creative_material_type	int	必填	素材类型	1：竖版视频 2：横版视频