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

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

campaign_id

long

必填

快手短视频广告计划ID

campaign_name

string

可选

快手信息流广告计划名称

不能修改为空，长度为1-100个字符，计划名称不能重复

day_budget

long

可选

单日预算金额

单位：厘，指定0表示预算不限，默认为0；

不小于500元，不超过100000000元，仅支持输入数字；

修改预算不得低于该计划当日花费的120%，与day_budget_schedule不能同时传，不能低于该计划下任一快手信息流广告组出价

day_budget_schedule

long[]

可选

分日预算

单位：厘，指定0表示预算不限，默认为0；

每天不小于500元，不超过100000000元，仅支持输入数字；

修改预算不得低于该计划当日花费的120%，与day_budget不能同时传，均不能低于该计划下任一快手广告组出价

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

campaign_id

long

计划ID

请求样例

curl -X POST \

 -H 'Access-Token: 303dca831ed2f3b30c9c21' \

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

 -d '{

   "advertiser_id": 20000800,

   "campaign_id":2342843,

   "day_budget":666666

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

返回样例

{

   "code": 0,

   "message": "OK",

   "data": {

       "campaign_id":2342917

   }

}

请求参数

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手信息流广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手推广组ID

emplate_id

long

选填

定向模板id

use_app_market

int

优先从系统应用商店下载

下载模式

允许值：0，1；

1：优先从系统应用商店下载使用，默认0。

仅提升应用安装计划类型且选择的app为安卓才支持。

app_store

string[]

应用商店列表

华为：huawei,

OPPO：oppo

VIVO：vivo

小米：xiaomi

魅族：meizu

锤子：smartisan

只支持计划类型为 2 且应用是 Android 类型的推广

unit_name

string

可选

快手广告组名称

不能修改为空，长度为1-100个字符，组名称不能重复

bid

long

可选

出价

bid_type为CPC/eCPC时该字段必填，单位：厘，不得低于0.2元，不得高于100元，不得高于组预算

cpa_bid

long

可选

出价

bid_type是OCPC时该字段必填，单位：厘，ocpx_action_type为2时，不得低于1元，不得高于3000元；

ocpx_action_type为180时，不得低于1元，不得高于3000元；

ocpx_action_type为53时，不得低于5元，不得高于3000元；

不得高于组预算

smart_bid

int

可选

优先低成本出价（是否设置）

0：手动出价，1：自动出价

1、当 speed 等于 3 的时候，修改广告组时 smart_bid 不能修改，speed 是可以修改的

2、当 speed 等于 3 和  smart_bid 为 1 的话，speed 和 smart_bid 都不能修改

deep_conversion_bid

long

可选

深度转化目标出价

单位：厘，仅当deep_conversion_type可用且账户满足白名单时选填，出价需大于cpa_bid，小于min{组预算，3000元}，不支持从0改为其他值，也不支持从其他值改为0

roi_ratio

double

可选

付费ROI系数

优化目标为「首日ROI」时必填：

ROI系数取值范围 ( 0,100 ] 最多支持到三位小数（如：0.066）    

scene_id

int[]

可选

资源位置

联盟广告不可修改，广告组下有创意也不能修改

begin_time

string

可选

投放开始时间

格式为yyyy-MM-dd，需大于等于当前时间

end_time

string

可选

投放结束时间

格式为yyyy-MM-dd，传空字符串表示从今天开始长期投放，传值表示设置开始时间和结束时间，且投放结束时间需大于等于投放开始时间

schedule_time

string

可选

投放时间段

格式为24*7位字符串，且都为0和1，以一个小时为最小粒度，从周一零点开始至周日24点结束；0为不投放，1为投放，不传/全传1/全传0视为全时段投放

day_budget

long

可选

单日预算金额

单位：厘，指定0表示预算不限，默认为0；

不小于100元，不超过100000000元，仅支持输入数字；

修改预算不得低于该广告组当日花费的120%，与day_budget_schedule不能同时传，不能低于广告组出价

day_budget_schedule

long[]

可选

分日预算

单位：厘，指定0表示预算不限，默认为0；

每天不小于100元，不超过100000000元，仅支持输入数字；

修改预算不得低于该广告组当日花费的120%，与day_budget不能同时传，均不能低于该广告组出价

url_type

int

可选

url类型

当计划类型为3（获取电商下单）时必填：

1 - 淘宝商品短链

2 - 淘宝商品itemID

4 - 金牛电商

web_uri_type

int

url类型

当计划类型为5（收集销售线索）&使用建站时必填：需使用魔力建站

不传默认1，2：落地页

url

string

可选

投放链接

当计划类型是3/4/5时必填；

长度不超过1000字符；

计划类型是3（获取电商下单）：根据url_type的类型表示短链或ID；

计划类型是4（推广品牌活动）：落地页URL；

计划类型是5（收集销售线索）：落地页URL

计划类型是5（收集销售线索）：建站id，通过/rest/openapi/v2/lp/page/list获取

schema_uri

string

可选

调起链接

提升应用活跃营销目标的调起链接

支持营销目标为“提升应用安装”的广告计划，填写应用直达链接

app_id

long

可选

应用ID

当计划类型为2时必填，可通过应用列表接口获取应用ID

show_mode

int

可选

创意展现方式

1 - 轮播

2 - 优选

speed

int

可选

投放方式

1 - 快速投放

2 - 平滑投放

3 - 优先低成本（投放时间范围只可为全天；预算不可为不限或空）

site_type

int

加白可选

预约广告

1:IOS预约

缺省为不传或传0

gift_data

struct

可选

游戏礼包码

更新的时候如果要清空数据传 「"gift_data": {}」 即可。只支持计划类型为 2 的。

video_landing_page

Boolean

可选

是否使用落地页前置功能

true: 使用 false：不使用，

不填使用系统默认值

（只支持双feed流，推广品牌活动-落地页url填写、获取电商下单-淘客短链url填写、获取电商下单-金牛活动页、获取销售线、获取销售线索）

asset_mining

boolean

unit_type=7选填

程序化创意2.0素材挖掘

是否开启历史素材挖掘

auto_target

boolean

选填

智能定向

若开启智能定向，定向部分仅保留地域+年龄+性别+排除人群+系统纬度的定向，其他定向纬度暂不支持（报错处理）

true表示开启，false表示未开启

target

struct

可选

定向数据

具体见下方表格