修改程序化创意

开发环境

http://dev-cn.your-api-server.com

POST

https://ad.e.kuaishou.com/rest/openapi/gw/dsp/advanced_creative/update

请求参数

字段	类型	是否必填	是否可更改	说明	备注
advertiser_id	long	必填	-	账户 ID
unit_id	long	必填	-	广告组 ID	一个组下只能有一个程序化创意
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[]	选创意分类必填	是	创意标签	与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 20 个；单个创意标签不能为空且不能超过 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-开启，不传默认关闭。仅白名单用户可以使用。

photo_list

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

new_expose_tag

字段	类型	是否必填	说明	备注
text	string	必填	广告标签text
url	string	选填	广告标签url

返回参数

字段	类型	说明	备注
code	int	返回码
message	string	返回信息
data	struct	JSON 返回值
unit_id

请求参数

无

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/gw/dsp/advanced_creative/update'

响应示例

{}

修改于 2023-10-24 04:02:51

修改自定义创意

批量修改自定义创意