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

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：检测到用户行为

code

string

礼包码

最多20字符，只能字母+数字

特殊校验规则

字段

特殊校验规则

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: 69d99a7c1f1823f4b271b' \

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

 -d '{

   "advertiser_id": 20000800,

   "campaign_id": 2342843,

   "unit_id":2960079,     

   "day_budget":500000,

   "bid_type":2,

   "cpa_bid": 28900,

   "bid":32266,

   "app_id":202,

   "page": 2,

   "begin_time":"2019-08-09",

   "end_time":"2019-09-09",

   "schedule_time":"000000000000000000000000000000000000000000000000000000000000000

00000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000

0000000000001",

   "show_mode":1,

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

   "speed":2,

   "target":{

       "gender":1,

       "network":0

   }

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

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "unit_id": 2960079

   }

}