1.快手广告代理商报表（t-1数据需要第二天9点以后获取）
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/agent/report
请求方式：POST
数据格式：JSON
字段 |
类型 |
描述 |
agent_id |
number |
代理商ID（注：非账户快手ID），在获取accessToken时返回 |
start_date |
string |
过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
end_date |
string |
过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
page |
int |
请求的页码，默认为 1 |
page_size |
int |
每页行数，默认为20，最大支持1000 |
字段 |
类型 |
描述 |
code |
int |
返回码/错误码 |
message |
string |
返回信息/错误信息 |
total_count |
int |
数据的总行数 |
details |
JSON |
数据明细信息 |
date_time |
string |
数据日期，格式：YYYY-MM-DD |
account_id |
long |
快手广告主ID |
user_id |
long |
快手id |
account_name |
long |
快手推广主名称 |
total_charged_in_yuan |
long |
总消耗（元） |
total_balance_in_yuan |
long |
总余额（元） |
real_charged_in_yuan |
long |
现金消耗（元） |
total_rebate_real_charged_in_yuan |
long |
返点消耗（元） |
contract_rebate_real_charged_in_yuan |
long |
框返消耗（元） |
direct_rebate_real_charged_in_yuan |
long |
激励消耗（元） |
credit_real_charged_in_yuan |
long |
信用消耗（元） |
charge_day_on_day_percent |
String |
消耗环比 |
ad_photo_impression |
long |
封面曝光数 |
ad_photo_click |
long |
封面点击数 |
ad_item_impression |
long |
素材曝光数 |
ad_item_click |
long |
行为数 |
photo_click_ratio |
String |
封面点击率 |
item_click_ratio |
String |
行为点击率 |
charged_campaign_count |
long |
有消费计划数 |
product_name |
string |
产品名 |
corporation_name |
string |
企业名称 |
first_cost_day |
long |
首次消耗日期 |
industry |
string |
一级行业 |
second_industry |
string |
二级行业 |
请求样例 |
curl --location --request POST 'https://ad.e.kuaishou.com/rest/openapi/v1/agent/report' \ --header 'Content-Type: application/json' \ --data-raw '{ "agent_id": 123, "start_date": "2020-07-09", "end_date": "2020-07-09", "page": 1, "page_size": 1000 }' |
2. 快手广告计划数据（实时）
请求快手信息流广告计划数据
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/campaign_report
请求方式：POST
数据格式：JSON
字段 |
类型 |
描述 |
advertiser_id |
long |
快手广告主ID（注：非账户快手ID），在获取accessToken时返回 |
start_date_min（必选其1） |
string |
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】 可选时间范围参见文档上方说明 |
end_date_min（必选其1） |
string |
增量拉取过滤筛选条件，格式【yyyy-MM-dd HH:mm】 可选时间范围参见文档上方说明 |
start_date（必选其2） |
string |
过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
end_date（必选其2） |
string |
过滤筛选条件，格式yyyy-MM-dd 可选时间范围参见文档上方说明 |
campaign_ids（可选） |
long[] |
快手广告计划ID集，过滤筛选条件，单次查询数量不超过5000 |
campaign_type（可选） |
int |
计划类型，过滤筛选条件 1 - 作品推广； 2 - 提升应用安装； 3 - 获取电商下单； 4 - 推广品牌活动； 5 - 收集销售线索； 6 - 保量广告； 7 - 提高应用活跃。 |
temporal_granularity（可选） |
string |
天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据 |
report_dims（可选） |
string[] |
"adScene"：按广告场景；不传/传空/传空数组：不限 |
page |
int |
请求的页码，默认为 1 |
page_size |
int |
每页行数，默认为20，最大支持2000 |
请求示例：
curl -H "Access-Token:d198a850da67a1f81279e30" \ -H "Content-Type:application/json" \ -d ' { "start_date": "2018-12-01", "end_date": "2018-12-23", "advertiser_id": 486, "temporal_granularity": "DAILY", "campaign_type": 3, "page_size": 2, "page": 1 } ' https://ad.e.kuaishou.com/rest/openapi/v1/report/campaign_report |
