创建创意
【注】快手联盟广告不支持便利贴图片素材,只有快手联盟广告支持横版竖版图片素材。
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/creative/create
请求方式：POST
数据格式：JSON
请求参数 |
||||
字段 |
类型 |
是否必填 |
说明 |
备注 |
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 } } |
