字段

类型

是否必填

说明

备注

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