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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手信息流广告组ID

creative_name

string

必填

创意名称

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

photo_id

string

可选

视频ID

image_token

string

可选

封面图片token

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

creative_material_type

int

必填

素材类型

1：竖版视频

2：横版视频

4：便利贴单图图片创意

5：竖版图片

6：横版图片

image_tokens

string[]

便利贴单图图片创意token

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

action_bar_text

string

必填

行动号召按钮文案

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

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

可从下方「获取已发布的下载页」接口获取（老建站6.30下线）

或通过「rest/openapi/v2/lp/page/list」获取新建站落地页（魔力建站"view_comps":[7]）

1.仅支持下载类广告

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

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

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

金融，教育，游戏，小说

如上行业必填

创意分类

由创意分类查询接口

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

必填快手账户可通过接口3.17——接口获取是否必填

creative_tag

List<String>

选创意分类 必填

创意标签

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

live_creative_type

int

选填

快手直播类型（快手小店直播推广类型，计划type=14）

1 - 快手直投直播

2 - 快手视频引流直播

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

creative_id

long

创意ID

特殊校验规则

字段

特殊校验规则

click_track_url/impression_url/ad_photo_played_t3s_url

1、链接必须以https开头；

2、链接中至少包含一个占位符，且拼写无误:

'__MAC__','__MAC2__','__MAC3__','__ANDROIDID2__','__ANDROIDID3__',

'__IMEI2__','__IMEI3__','__IDFA2__','__IDFA3__','__TS__','__IP__',

'__CALLBACK__','__DID__','__DNAME__','__CID__','__AID__'

请求样例

curl -X POST \

 -H 'Access-Token: 69d99a7c1fdf3f4b271b' \

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

 -d '{

       "advertiser_id": 20000152,

       "unit_id": 2959088,

       "creative_name": "market api 创建创意",

       "photo_id": "5227271801686",

       "creative_material_type": 1,

       "action_bar_text": "抢先关注",

       "description": "这是一个 market api 创建的创意",

       "click_track_url": "https://www.test.com/channel_ad/kuaishou/00754?imei=__IMEI2__&mac=__MAC__&callback_url=__CALLBACK__"

}' -L https://ad.e.kuaishou.com/rest/openapi/v2/creative/create

返回样例

{

 "code": 0,

 "message": "OK",

 "data": {

     "creative_id": 26377538

 }

}