王尘宇

请求参数

公共参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手直播广告组ID

一个unit最多创建15个创意

click_track_url

string

第三方点击检测链接

仅当快手广告组scene_id为1、2、6、7时，可选填；

广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手Android SDK时除外）

使用Marketing API创建时，监测链接使用以该文档为准

impression_url

string

第三方开始播放监测链接

仅当快手小店广告组scene_id为3时，可选填；

快手广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手Android SDK时除外）

使用Marketing API创建时，监测链接使用以该文档为准

ad_photo_played_t3s_url

string

第三方有效播放监测链接

仅历史个别快手推广账户使用且当广告组scene_id为3时可选，与impression_url不可同时使用

actionbar_click_url

string

可选

第三方点击按钮监测链接

1.校验click_url必填的广告场景 优选(1)/信息流(2、7)/上下滑（6）

2.优化目标为激活功能必填点击监测链接,但如果安卓应用接入了快手监测sdk就不需要填写监测链接了

3.联盟场景检查click_url不能为空

4.若广告联盟的转化目标为激活，click_url、actionbar_click_url和监测SDK至少三选一

creatives

struct[]

可选

批量参数

具体参数如下表

creatives

字段

类型

是否必填

说明

备注

creative_name

string

必填

创意名称

长度为1-100字符，同一个快手广告组下名称不能重复

creative_id

string

必填

创意id

更新时传入创意id不能重复

需要在对应unit_id下

photo_id

string

可选

视频 id

image_token

string

可选

封面图片 token

通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致

creative_material_type

int

必填

素材类型

1：竖版视频

2：横版视频

4：便利贴单图图片创意

image_tokens

string[]

便利贴单图图片创意token

便利贴创意必填，目前只支持一张图片，详细要求见附录

action_bar_text

string

必填

行动号召按钮文案

根据计划类型进行设置，详情见10.1

description

string

必填

快手广告语

长度为1-30字符，不支持换行。

short_slogan

string

便利贴创意短广告语

长度为1-8字符，便利贴创意必填参数

sticker_title

string

封面快手广告语标题

不超过14字符，

如果要使用动态词包，格式如"[地区]的[男性女性]都喜欢"，

后贴片广告不支持动态词包，

词包名可以通过下方动态词包接口获取，

sticker_title和overlay_type需同时为空值或同时非空

overlay_type

string

贴纸样式类型

贴纸样式可以通过查询下方贴纸掩饰接口获取，

sticker_title和overlay_type需同时为空值或同时非空

expose_tag

string

非必填

快手广告标签，更新的时候如果要将广告标签设置为 「暂不选择」，传空字符串即可，只支持计划类型为 2

从 /expose_tags/list 接口获取，通过创建接口9获取

site_id

long

安卓下载中间页ID

可从下方「获取已发布的下载页」接口获取

1.仅支持下载类快手广告

2.广告组选择的应用类型要为安卓

3.下载页对应的app_id要与快手广告组选择的app_id一致

请求样例

curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v2/creative/batch/update' \

--header 'access-token: c1a79b137a71c8e130a0ccaa746966bf' \

--header 'Content-Type: application/json' \

--data-raw '{

"advertiser_id": 4171736,

"unit_id":22826160,

"creatives":[

{

"creative_name":"测试4-1",

"creative_id":298846848,

"photo_id":5214605445653959402,

"creative_material_type":1,

"action_bar_text":"立即下载",

"description":"公共参数和批量参数传一个就行"

},

{

"creative_name":"测试5-1",

"creative_id":298846846,

"photo_id":5214605445653959402,

"creative_material_type":1,

"action_bar_text":"立即下载",

"description":"公共参数和批量参数传一个就行"

},

{

"creative_name":"测试6-1",

"creative_id":298846847,

"photo_id":5214605445653959402,

"creative_material_type":1,

"action_bar_text":"立即下载",

"description":"公共参数和批量参数传一个就行"

}

]

}'