| 字段 | 类型 | 是否必填 | 说明 | 备注 |
|---|---|---|---|---|
| advertiser_id | long | 账户 ID | ||
| unit_id | long | 广告组 ID | 一个组下只能有一个程序化创意 | |
| package_name | string | 程序化创意名称 | 1-100 字符 | |
| horizontal_photo_ids | string[] | 横版视频 ID list | 横版视频与竖版视频字段至少传一个,可共传,但横版+竖版视频最多可传 5 个。 | |
| vertical_photo_ids | string[] | 竖版视频 ID list | 横版视频与竖版视频字段至少传一个,可共传,但横版+竖版视频最多可传 5 个。 | |
| cover_image_tokens | string[] | 封面 list image_token | 最多可传 4 个,智能抽帧下需要为空 | |
| site_id | long | 建站 id | 计划类型为 2 的时候才有效,需要和组层级选择的 app_id 保持一致 | |
| 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,监测链接必填 | |
| creative_category | int | 可选 | 创意分类 | 由创意分类查询接口获得; 必须是叶子结点;与创意标签同时传或同时不传 |
| creative_tag | List | 选创意分类 必填 | 创意标签 | 与创意分类参数,要么都传,要么都不传;且单个创意的创意标签最多 20 个;单个创意标签不能为空且不能超过 10 字符 |
| pic_list | string[] | 可选 | 联盟图片(横版/竖版) | 需要传入image_token列表,image_token通过上传图片接口获取 |
| photo_list(程序化创意 3.0 字段) | 类型 | 是否必填 | 说明 | 备注 |
|---|---|---|---|---|
| photo_id | number | 新版必填 | 视频 ID | |
| cover_image_token | string | 新版必填 | 封面图片 token | 通过上传图片接口获得,不传值则直接使用视频的首帧作为封面图片,自定义封面的图片宽高要与视频宽高一致,使用智能抽帧时不需要传递。 |
| creative_material_type | number | 新版必填 | 素材类型 | 1:竖版视频 2:横版视频 |
curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/creative/advanced/program/update'{}