1.历史快手广告投放数据（建议每天错峰拉取）
1） 创建历史数据查询任务
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/async_task/create
请求方式：POST
数据格式：JSON
字段 |
类型 |
描述 |
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：快手APP广告创意维度查询 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 |
2） 获取任务列表
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/async_task/list
请求方式：POST/GET
数据格式：JSON
字段 |
类型 |
是否必填 |
描述 |
advertiser_id |
long |
必填 |
快手广告主ID（注：非账户快手ID），在获取accessToken时返回 |
task_ids |
long[] |
可选 |
任务ID集，不超过10个 |
page |
int |
可选 |
页码，默认 1 |
page_size |
int |
可选 |
每页行数，默认 20 |
返回参数 |
|||
字段 |
类型 |
说明 |
备注 |
code |
int |
返回码 |
|
message |
string |
返回信息 |
|
data |
struct |
JSON返回值 |
|
total_count |
int |
任务总数 |
|
details |
struct[] |
||
advertiser_id |
long |
快手广告主ID |
|
task_id |
long |
任务ID |
|
task_name |
string |
任务名称 |
|
create_time |
string |
任务创建时间 |
格式如：yyyy-MM-dd HH:mm:ss |
task_status |
int |
任务状态 |
0：新建，1：处理中，2：处理成功，3：处理失败 |
file_size |
int |
文件大小 |
字节数 |
3） 下载数据
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/async_task/download
请求方式：GET
结果字段：CSV文件中的字段同实时报表
字段 |
类型 |
是否必填 |
描述 |
advertiser_id |
long |
必填 |
快手广告主ID（注：非账户快手ID），在获取accessToken时返回 |
task_id |
long |
必填 |
任务ID |
