快手历史广告投放数据（建议每天错峰拉取）

字段

类型

描述

advertiser_id

long

快手广告主ID（注：非快手信息流广告账户快手ID），在获取accessToken时返回

task_name

string

任务名称，最大不超过32字符，不能为空；

每个快手账户提交的任务名称不能重复

task_params

struct

报表任务参数，详见下方

快手task_params

字段

快手类型

是否必填

说明

备注

start_date

string

必填

查询开始日期

格式如：yyyy-MM-dd，时间跨度不能超过6个月

end_date

string

必填

查询结束日期

格式如：yyyy-MM-dd，不大于查询开始日期

view_type

int

必填

查询维度

1：快手账户维度查询，

2:  快手广告计划维度查询，

3：快手广告组维度查询，

4：快手广告创意维度查询

5：视频报表

6：程序化创意1.0报表

7：封面报表

8：便利贴报表

10：程序化创意2.0报表

campaign_ids

long[]

可选

广告计划ID集

unit_ids

long[]

可选

快手广告组ID集

creative_ids

long[]

可选

广告创意ID集

photo_ids(可选)

long[]

可选

视频ID集

仅view_type=5、7、8可使用

cover_ids(可选)

long[]

可选

封面ID集

仅view_type=5、7、8可使用

virtual_creative_ids

long[]

可选

程序化创意ID集

进行virtual_creative_id的筛选

report_dims

string

可选

投放场景

"adScene"：按广告场景；

不传/传空/传空数组：不限

temporal_granularity

string

可选

时间粒度

“DAILY”：天粒度；

“HOURLY”：小时粒度；

默认按天粒度进行聚合

status

int

可选

状态

1：投放快手广告中；2：已暂停；3：已删除

返回参数

字段

类型

说明

备注

code

int

返回码

message

string

返回信息

data

struct

JSON返回值

advertiser_id

long

快手广告主ID

task_id

long

任务ID