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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手广告组ID

creative_name

string

必填

计划类型

创意名称，长度为1-100字符，同一个广告组下名称不能重复

action_bar_text

string

必填

行动号召按钮文案

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

click_track_url

string

第三方点击检测链接

快手广告组优化目标为激活/表单时，该字段必填

programmed_creative_material

struct

程序化创意物料

详见下方

site_id

long

安卓下载中间页ID

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

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

1.仅支持下载类快手广告

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

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

programmed_creative_material

字段

类型

是否必填

说明

备注

materials

struct[]

是

物料信息

1-8个，详见下方

sticker_style_ids

int[]

封面贴纸类型ID

1-6个，不可重复，与sticker_titles同时为空或同时非空

sticker_titles

string[]

快手封面广告语

1-6个，每个不超过14个字符，与sticker_style_ids同时为空或同时非空

description_titles

string[]

必填

快手广告语

支持1-6个，每个长度为1-30字符

materials

字段

类型

是否必填

说明

备注

photo_id

string

是

视频ID

image_tokens

string[]

封面图片token

1-4个，图片要求：分辨率不低于540*540、jpg格式、大小不大于2M

creative_material_type

int

是

素材类型

1：竖版视频

2：横版视频

需要与photo_id保持一致

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

creative_id

long

创意ID

特殊校验规则

字段

特殊校验规则

click_track_url

1、链接必须以https开头；

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

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

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

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

请求样例

返回样例