age |
快手直播广告怎么推广呢？ | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
min |
int |
必填 |
年龄最小限制 |
年龄区间最小为5岁 |
max |
int |
必填 |
年龄最大限制 |
年龄区间最大为55岁，且年龄最大限制须大于等于年龄最小限制 |
特殊校验规则 |
快手信息流推广开户代理商 |
字段 |
特殊校验规则 |
url |
1、不能为空，不能超过1000字符； 2、url_type为2时，url必须是数字的ID； 3、url_type为1时，url表示淘短链，需符合正则表达式https?:\/\/.*(s\.click)|(uland)，短链长度不能超过100字符； 4、金融行业有白名单校验。 |
返回参数 |
快手广告代理 | ||
字段 |
类型 |
说明 |
备注 |
code |
int |
返回码 |
|
message |
string |
返回信息 |
|
data |
struct |
JSON返回值 |
|
unit_id |
long |
广告组ID |
修改快手广告创意
【注】快手联盟广告不支持便利贴图片素材。
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/creative/update
请求方式：POST
数据格式：JSON
请求参数 |
||||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
必填 |
快手广告主ID |
在获取access_token的时候返回 |
creative_id |
long |
必填 |
快手广告创意ID |
|
creative_name |
string |
可选 |
快手广告创意名称 |
不能修改为空，长度为1-100个字符，创意名称不能重复 |
photo_id |
string
|
可选 |
视频ID |
支持Marketing API上传的视频 |
image_token |
string |
可选 |
封面图片token |
通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致 如果原封面未自定义无法使用视频首帧作为封面。 |
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 接口获取 更新的时候如果要将广告标签设置为 「暂不选择」，传空字符串即可，只支持计划类型为 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修改时，监测链接的使用以该文档为准 |
ad_photo_played_t3s_url |
string |
可选 |
第三方有效播放监测链接 |
仅历史个别快手广告账户使用且当广告组scene_id为3、6时可选，与impression_url不可同时使用 |
impression_url |
string |
可选 |
第三方开始播放监测链接 |
仅当广告组scene_id为3时，可选填； 快手广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手Android SDK时除外） 使用Marketing API修改时，监测链接的使用以该文档为准 |
creative_category |
int |
可选 |
创意分类 |
由创意分类查询接口获得； 必须是叶子结点；与创意标签同时传或同时不传 |
creative_tag |
List<String> |
选创意分类 必填 |
创意标签 |
与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多20个；单个创意标签不能为空且不能超过10字符 |
返回参数 |
快手开户 | ||
字段 |
类型 |
说明 |
备注 |
code |
int |
返回码 |
|
message |
string |
返回信息 |
|
data |
struct |
JSON返回值 |
|
creative_id |
long |
创意ID |
特殊校验规则 |
快手信息流推广开户平台 |
字段 |
特殊校验规则 |
click_track_url/impression_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: 69d99a7c1fd823f4b271b' \ -H 'Content-Type: application/json' \ -d '{ "advertiser_id": 20000152, "creative_id": 2959088, "photo_id": "5227271804177341686", "action_bar_text": "抢先关注", "description": "这是一个 market api 创建的创意", "click_track_url": "https://adcore.aidalan.com/channel_ad/kuaishou/pf/1/junhai_adid/65067/game_id/U200000754?imei=__IMEI__&mac=__MAC__&callback_url=__CALLBACK__" }' -L https://ad.e.kuaishou.com/rest/openapi/v2/creative/update、 |
返回样例 |
{ "code": 0, "message": "OK", "data": { "creative_id": 26377538 } } |
