advertiser_id

long

必填

快手短视频广告主ID

在获取access_token的时候返回

campaign_id

long

可选

快手信息流广告计划ID

过滤筛选条件，若不传或传空则视为无限制条件

campaign_type

int

可选

快手短视频广告计划类型

过滤筛选条件；2 - 提升应用安装;3 - 获取电商下单;4 - 推广品牌活动;5 - 收集销售线索;

unit_id

long

可选

快手信息流广告组ID

过滤筛选条件，若不传或传空则视为无限制条件

unit_name

string

可选

快手APP短视频广告组名称

过滤筛选条件，支持模糊搜索&精确查询

unit_ids

long[]

可选

快手广告组ID集

不超过100个

status

int

可选

快手广告组状态

过滤筛选条件；-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：审核中，12：审核未通过，14：已结束，15：已暂停，17：组超预算，19：未达投放时间，20：有效-2，22：不在投放时段。所有包含已删除10：只包含已删除不传：所有不包含已删除 其他值无效

app_name

string

可选

应用名称

过滤筛选条件，支持模糊搜索

start_date

string

可选

开始时间

与end_date同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息

end_date

string

可选

结束时间

与start_date同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应update_time信息

time_filter_type

int

可选

按创建时间或者更新时间进行筛选

1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为1时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为0时，则按照更新时间进行筛选

page

int

可选

请求的页码数

默认为1

page_size

int

可选

请求的每页行数

默认为20

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

details

struct

返回值详情

campaign_id

long

快手广告计划ID

unit_id

long

快手广告组ID

unit_name

string

快手广告组名称

status

int

快手广告组状态（优先看看这个状态，计算结果）

-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，，11：审核中，12：审核未通过，14：已结束，15：已暂停，17：组超预算，19：未达投放时间，20：有效

put_status

int

投放状态（操作结果）

1：投放中；2：暂停 3：删除

create_channel

int

创建渠道

0：快手推广后台创建；1：Marketing API创建

review_detail

string

审核拒绝理由

study_status

int

学习期

1:学习中,2:学习成功,3:学习失败

compensate_status

int

赔付状态

0=不需要赔付(不需要展示赔付标志)，1=成本保障生效中，2=成本保证确认中，3=已赔付完成，4=已失效

bid_type

int

出价类型

1：CPM，2：CPC，6：OCPC(使用OCPC代表OCPX)，10：OCPM，20：eCPC

bid

long

出价

单位：厘

cpa_bid

long

OCPC出价

单位：厘

smart_bid

int

优先低成本是否自动出价

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

ocpx_action_type

int

优化目标

0：未知，2：点击转化链接，10：曝光，11：点击，31：下载完成，53：提交线索，109：电话卡激活，137：量房，180：激活，190: 付费，191：首日ROI，348：有效线索，383: 授信，384: 完件 715：微信复制;739:7日付费次数

deep_conversion_type

int

深度转化目标

3: 付费，7: 次日留存，10: 完件, 11: 授信 ，0：无

deep_conversion_bid

long

深度转化目标出价

白名单功能，单位：厘

day_budget

long

单日预算

单位：厘

day_budget_schedule

long[]

分日预算

单位：厘，单日预算和分日预算同时存在时，以分日预算为准

roi_ratio

double

付费ROI系数

优化目标为「首日ROI」时必填：ROI系数取值范围 ( 0,100 ] 最多支持到三位小数（如：0.066）

speed

int

投放方式

0：未知，1：正常投放，2：平滑投放，3：优先低成本。

begin_time

string

投放开始时间

格式：yyyy-MM-dd

end_time

string

投放结束时间

格式：yyyy-MM-dd,排期不限为null

schedule

struct

投放时段

不投放的时段为null，详请见下方，历史字段，即将废弃

schedule_time

string

投放时段

24*7的字符串，0为不投放，1为投放，例如：0010000000001....0000

scene_id

int[]

快手广告位

1：快手优选广告位；2：按场景选择广告位-快手信息流广告（旧广告位，包含上下滑大屏广告）；3：快手视频播放页广告-便利贴广告；6：快手上下滑大屏广告；7：快手信息流广告（不包含快手上下滑大屏广告）10：激励视频；11：快看点场景

show_mode

int

创意展现方式

0：未知，1：轮播，2：优选

unit_type

int

创意制作方式

4: 自定义；5：程序化创意 7：程序化创意2.0

convert_id

int

转化目标

use_app_market

int

优先从系统应用商店下载

0：未设置 1：优先从系统应用商店下载使用

app_store

string[]

应用商店列表

url_type

int

url类型

当计划类型为3时（获取电商下单）时有返回。1：淘宝商品短链 2：淘宝商品itemID

web_uri_type

int

url类型

当计划类型为5（收集销售线索）&使用建站时有返回：需使用魔力建站 不传默认1，2：落地页

url

string

落地页链接

计划类型是 2（提升应用安装）：返回应用下载地址；计划类型是 3（获取电商下单）：根据url_type返回相应信息；计划类型是 4（快手推广品牌活动）：返回落地页url计划类型是 5（收集销售线索）：返回落地页url计划类型是5（收集销售线索）：建站idl

schema_uri

string

调起链接

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

app_id

long

应用ID

app_icon_url

string

APP图标存储地址

diverse_data

struct

应用信息

详情见下方

total_count

int

数据总数

target

struct

定向数据

详情见下方

site_type

int

快手预约广告

1:IOS预约 缺省为不传或传0

gift_data

struct

游戏礼包码（见下）

联盟广告暂不支持

video_landing_page

Boolean

是否使用落地页前置功能

true: 使用 false：不使用

auto_target

boolean

智能定向

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

smart_cover

boolean

程序化创意2.0智能抽帧

是否开启智能抽帧

asset_mining

boolean

程序化创意2.0素材挖掘

是否开启历史素材挖掘

auto_create_photo

boolean

是否开启自动生成视频

update_time

string

最后修改时间

格式样例："2019-06-11 15:17:25"

item_id

long

电商关联Id (小店通)

1. merchantItemType为0时表示小店商品id; 2. merchantItemType为2时表示快手id

fiction_id

long

小说ID

仅支持“提升应用安装”、“收集销售线索”以及“提高应用活跃”三种计划类型，且一旦绑定，不可修改。此参数仅是绑定小说，并非自动关联小说生成的落地页，如需推广小说生成的落地页，请使用小说ID获取其生成的建站落地页后将落地页ID一并传入即可（落地页ID传参与之前建站落地页ID字段一致）

merchant_item_put_type

int

电商广告投放类型（小店通）

0: 商品; 2: 个人主页

consult_id

long

是否使用了咨询组件

0=未使用，1=使用；注，咨询组件仅在收集销售线索计划(campaign_type=5)下可用，且使用了咨询组件后，可用的行动号召按钮限于接口返回内容

adv_card_option

int

高级创意开关

0：关闭 1:开启

adv_card_list

struct[]

高级创意列表

adv_card_id

long

卡片id

card_type

int

卡片类型

100:图片卡片 101:多利益卡-图文 102：多利益卡-多标签 103：电商促销样式

url

string

图片url

title

string

标题

sub_title

string

副标题

price

int

原价格(单位：分)

sale_price

int

售卖价(单位：分)

backflow_forecast

json

{"backflow_cv_lower": 2,"backflow_cv_upper": 5,"backflow_timestamp": 1614134110150,"backflow_payment":100,"backflow_roi":0.33}

backflow_cv_lower：回流预估值的下限；backflow_cv_upper：回流预估值的上限；backflow_timestamp：本次回流预估数据的时间戳，13位毫秒时间戳;backflow_payment：回流预估总金额;backflow_roi：回流首日预估ROI

merchandise_id

long

商品ID，且一旦绑定，不可修改

此参数用于绑定商品（绑定商品类型受merchandise_type字段控制），与 fiction_id 字段互斥。merchandise_type=2，merchandise_id 为课程ID，仅支持“收集销售线索”计划类型，且一旦绑定不可修改

merchandise_type

int

课程类型

与 merchandise_id 共同使用，merchandise_type=2，merchandise_id 为课程ID，仅支持“收集销售线索”计划类型，且一旦绑定不可修改

playable_orientation

int

试玩素材的横竖适配

默认值为-1；0:横竖均可；1:竖屏；2:横屏

playable_url

string

试玩的url

playable_file_name

string

快手试玩广告的文件名

playable_switch

int

快手试玩广告的开关

默认值为0；1:关闭；2:开启

playable_id

Long

试玩 ID

可选字段，开启试玩时存在，否则不存在。当用户上传试玩素材成功时返回，用于之后对于广告组中试玩创意的编辑操作。

play_button

String

试玩按钮文字内容

开启试玩时存在，否则不存在，示例按钮内容如下：1：立即试玩；2：试玩一下；3：立即体验；4：免装试玩；5：免装体验。启用试玩时：默认“立即试玩”，未启用试玩时：内容为空。

splash_ad_switch

boolean

是否投放快手开屏广告位

true:投放，false：不投放

library_id

int

商品库ID

sdpa类型广告组才会存在

outer_id

String

商品ID

快手sdpa类型广告组才会存在

product_name

String

商品名称

快手sdpa类型广告组才会存在

product_price

Double

商品价格

单位：元，快手sdpa类型广告组才会存在

product_image

String

商品主图

快手sdpa类型广告组才会存在

intention_target

boolean

行为意向-系统优选

行为意向是否开启系统优选，智能定向和行为意向系统优选不能同时开启