快手广告管理平台Marketing API开发文档《NO.10》

请求参数

公共参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手广告组ID

一个组下只能有一个程序化创意，只有这个快手广告组的 unit_type 为 7 才能创建程序化创意

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，监测链接必填

actionbar_click_url

string

第三方 ActionBar 点击监控链接

部分客户使用

actionbar_click_url不为空时，click_url必填，不能超过 1024 字符

creative_category

int

可选

创意分类

由创意分类查询接口获得；

必须是叶子结点；与创意标签同时传或同时不传

creative_tag

List<String>

选创意分类 必填

创意标签

与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多20个；单个创意标签不能为空且不能超过10字符

请求参数

公共参数

字段

类型

是否必填

说明

备注

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至少三选一

creative_category

int

可选

创意分类

由创意分类查询接口

获得；必须是叶子结点；与创意标签同时传或同时不传

creative_tag

List<String>

选 创意分类必填

创意标签

与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多20个；单个创意标签不能为空且不能超过10字符

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

非必填

快手广告标签

从 /expose_tags/list 接口获取，下方第9点。

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

new_expose_tag

string[]

非必填

快手广告标签2期

与老的expose_tag兼容, 逐渐将老的expose_tag替换掉。可以按照相关格式传递两个推荐理由

举例[{“text”:""},{"text":""}]

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",

"photo_id":5214605445653959402,

"creative_material_type":1,

"action_bar_text":"立即下载",

"description":"支持建站工具的落地页",

"overlay_type":"6_1",

"sticker_title":"你好啊[男性女性]"

},

{

"creative_name":"测试5",

"photo_id":5214605445653959402,

"creative_material_type":1,

"action_bar_text":"立即下载",

"description":"支持建站工具的落地页",

"overlay_type":"6_1",

"sticker_title":"你好啊[男性女性]"

},

{

"creative_name":"测试6",

"photo_id":5214605445653959402,

"creative_material_type":1,

"action_bar_text":"立即下载",

"description":"支持建站工具的落地页",

"overlay_type":"6_1",

"sticker_title":"你好啊[男性女性]"

}

]

}'

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "update_creative_ids": [],

       "add_creative_ids": [

           298846848,

           298846846,

           298846847

       ]

   }

}