王尘宇

age

字段

类型

是否必填

说明

备注

min

int

必填

年龄最小限制

年龄区间最小为18岁

max

int

必填

年龄最大限制

年龄区间最大为55岁，且年龄最大限制须大于等于年龄最小限制

intelli_extend

字段

类型

是否必填

说明

备注

is_open

int

开启智能扩量

默认为0，为1时打开智能扩量，其他数值报错；关闭智能扩量时，以下三个字段必须为0

no_age_break

int

不可突破年龄

默认为0（可突破/无需控制），定向age数据不为空时，可设为1（不可突破）。

no_gender_break

int

不可突破性别

默认为0（可突破/无需控制），定向gender数据不为空时，可设为1（不可突破）。

no_area_break

int

不可突破地域

默认为0（可突破/无需控制），定向region数据不为空时，可设为1（不可突破）。

gift_data

字段

类型

是否必填

说明

备注

target_action_type

int

发送时机

android（支持的类型）:

如果选择「优先从系统应用商店下载」（use_app_market 为 1）：

2：检测到用户行为（actionBar 点击）

没有选择优先应用商店下载：

30： 开始下载后

31：下载完成后

32：安装完成后

ios（ios支持的类型）：

2：检测到用户行为（actionBar 点击）

code

string

礼包码

最多20字符，只能字母+数字，一个中文汉字算两个字符

behavior_interest

字段

类型

是否必填

说明

备注

behavior

struct

必填

行为定向

behavior与interest同时不传，则清空行为兴趣定向

interest

struct

选填

兴趣定向

behavior与interest同时不传，则清空行为兴趣定向

behavior

字段

类型

是否必填

说明

备注

keyword

struct[]

非必填

行为定向关键词

根据/rest/openapi/v1/tool/keyword/query接口获取

label

string[]

非必填

行为定向 类目词

根据/rest/openapi/v1/tool/label/behavior_interest接口获取。将行为类目id从最高层类目id开始，以“-”连接起来，假如有一个类目id为80202，父类目id为802，最高层类目id为8，则此时应该写["8-802-80202"]；如果想全选最高层类目"8"底下的所有子类目，填["8"]

time_type

int

必填

在多少天内发生行为的用户

0:7天

1：15天

2：30天

3：90天

4：180天

strength_type

int

必填

行为强度

0：不限

1：高强度

scene_type

int[]

必填

行为场景

1：社区

2：APP

4：快手推广

keyword

字段

类型

是否必填

说明

备注

id

long

必填

关键词id

id与name需互相匹配

name

string

必填

关键词名称

id与name需互相匹配

interest

字段

类型

是否必填

说明

备注

label

string[]

非必填

兴趣定向类目词

根据/rest/openapi/v1/tool/label/behavior_interest接口获取。将兴趣类目id从最高层类目id开始，以“-”连接起来，假如有一个类目id为80202，父类目id为802，最高层类目id为8，则此时应该写["8-802-80202"]；如果想全选最高层类目"8"底下的所有子类目，填["8"]

dpa_unit_param

字段

类型

是否必填

说明

备注

library_id

long

当子计划类型为sdpa时必填

商品库ID

outer_id

string

当子计划类型为sdpa时必填

外部商品ID

detail_unit_type

int

当计划类型为sdpa时必填

商品链接类型

0：app下载

1：H5跳转，

2：Deeplink唤起，

productId

string

当计划子类型为sdpa时必填

快手商品ID

click_url

string

当计划子类型为dpa使用

点击跳转监控链接

actionbar_click_url

string

当计划子类型为dpa使用

actionbar点击跳转监控链接

impression_url

string

当计划子类型为dpa使用

曝光监控链接

特殊校验规则

字段

特殊校验规则

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

请求样例

curl -X POST \

 -H 'Access-Token: 69d99a7c1fdf3f4b271b' \

 -H 'Content-Type: application/json' \

 -d '{

       "advertiser_id": 20000152,

       "campaign_id": 2342062,

       "unit_name":"market api 创建计划",

       "bid_type":6,

       "cpa_bid": 20000,

       "ocpx_action_type": 2,

       "scene_id": [3],

       "unit_type": 4,

       "begin_time":"2019-05-01",

       "end_time":"2019-05-13",

       "url":"https://www.kuaishou.com",

       "show_mode":1,

       "speed":1,

       "target": {

       "region":[56576],

       "age": {

           "min": 5,

           "max": 55

       },

       "gender": 0

       }

}' -L   https://ad.e.kuaishou.com/rest/openapi/v2/ad_unit/create

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "unit_id": 2959088

   }

}