快手广告投放平台API对接：修改广告模块《NO.7》

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

请求参数

字段

类型

是否必填

说明

备注

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

 }

}