1. 修改快手广告计划
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/campaign/update
请求方式：POST
数据格式：JSON
请求参数 |
||||
字段 |
类型 |
是否必填 |
说明 |
备注 |
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 } } |
2.修改快手广告组
请求接口：https://ad.e.kuaishou.com/rest/openapi/v2/ad_unit/update
请求方式：POST
数据格式：JSON
请求参数 |
快手短视频广告投放平台 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
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 |
可选 |
定向数据 |
具体见下方表格 |
