快手历史广告投放数据（建议每天错峰拉取）
1） 创建历史数据查询任务
请求接口：https://ad.e.kuais hou.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：快手广告创意维度查询 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 |
