1. 程序化创意2.0报表（实时）
请求快手广告创意数据
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/program_creative_report
请求方式：POST
数据格式：JSON
字段 |
类型 |
描述 |
advertiser_id |
long |
快手广告主ID（注：非账户快手ID），在获取accessToken时返回 |
start_date_min（必选） |
string |
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】 可选时间范围参见文档上方说明 |
end_date_min（必选） |
string |
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】 可选时间范围参见文档上方说明 |
campaign_ids（可选） |
long[] |
快手广告计划ID集，过滤筛选条件，单次查询数量不超过5000 |
unit_ids（可选） |
long[] |
快手信息流广告组ID集，过滤筛选条件，单次查询数量不超过5000 |
temporal_granularity（可选） |
string |
天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据 |
report_dims（可选） |
string[] |
"adScene"：按快手广告场景；不传/传空/传空数组：不限 |
page |
int |
请求的页码，默认为 1 |
page_size |
int |
每页行数，默认为20，最大支持2000 |
字段 |
类型 |
描述 |
code |
int |
返回码/错误码 |
message |
string |
返回信息/错误信息 |
data |
JSON |
|
total_count |
int |
数据的总行数 |
details |
JSON |
数据明细信息 |
其他信息与实时报表保持一致，如下为新增参数 |
||
campaign_id |
long |
计划id |
campaign_name
|
string |
计划名称 |
unit_id |
long |
组id |
unit_name |
string |
组名称 |
creative_id |
long |
创意id |
photo_url |
string |
视频链接 |
photo_id |
string |
视频id |
image_token |
string |
封面id |
cover_url |
string |
封面链接 |
description |
string |
作品快手广告语 |
2. 人群分析报表
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/audience_report
请求方式：POST
数据格式：JSON
请求参数 |
快手广告投放平台 | |||
字段 |
类型 |
是否必填 |
说明 |
备注 |
advertiser_id |
long |
是 |
||
start_date |
string |
是 |
开始日期 |
格式YYYY-MM-DD,只支持查询2016-10-26及以后的日期 |
end_date |
string |
是 |
结束日期 |
格式YYYY-MM-DD,只支持查询昨天之前的数据 |
campaign_ids |
long[] |
否 |
广告计划ID集 |
过滤筛选条件，单次查询数量不超过5000 |
unit_ids |
long[] |
否 |
广告组ID集 |
过滤筛选条件，单次查询数量不超过5000 |
report_dims |
string[] |
是 |
人群报表类型 |
province: 省级地域分布 city: 地级地域分布 gender: 性别分布 ageSegment: 年龄分布 clientId: 系统分布 businessInterestTags: 商业兴趣分布 |
page |
int |
否 |
请求页码数 |
默认为 1 |
page_size |
int |
否 |
请求页码大小 |
默认为100，最大支持2000 |
返回参数 |
类型 |
描述 |
code |
int |
返回码/错误码 |
message |
string |
返回信息/错误信息 |
data |
JSON |
|
total_count |
int |
数据的总行数 |
details |
JSON |
数据明细信息 |
其他信息与实时报表保持一致，如下为新增参数 |
||
province |
string |
省份 |
city |
string |
城市 |
gender |
string |
性别 |
age_segment |
string |
年龄 |
client |
string |
系统 |
business_interest_tags |
string |
商业兴趣 |
