【注意事项】快手广告计划/快手广告组/快手广告创意报表查询接口，如果单次查询，需要处理的有效快手广告计划/快手广告组/快手广告创意数量超过5000，会提示“报表查询处理ID数比较多，请分批次传ID进行查询”。其中，“有效广告计划/广告组/广告创意数量”以请求的实际结果为准，并非快手账户里广告计划/广告组/广告创意的整体数量。
为了保证更稳定、更高效的报表数据查询，现新增历史投放报表数据接口，支持以异步任务的方式查询历史数据。原有的实时报表接口时间范围调整为近7天（含当天），历史投放报表接口时间范围为近12个月（含当天）；分时查询仅支持近7天（含当天）的数据。由于投放后台可查询时间范围近期有变动，Marketing API会尽快对齐。
1. 新增权限code
report_service（获取快手广告账户报表信息）
需要在授权URL的scope参数上添加 report_service，进行授权后才能访问获取快手信息流广告账户报表信息的接口，示例如下：
https://ad.e.kuaishou.com/openapi/oauth?app_id=1&scope=%5B%22report_service%22%5D&redirect_uri=https://e.kuaishou.com&state=abc
2. 报表查询
2.1 快手广告主数据（实时）
1） 请求快手广告主数据
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/report/account_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 可选时间范围参见文档上方说明 |
temporal_granularity（可选） |
string |
天粒度（DAILY）／小时粒度（HOURLY），默认支持天粒度数据 |
report_dims（可选） |
string[] |
"adScene"：按广告场景；不传/传空/传空数组：不限 |
page |
int |
请求的页码，默认为 1 |
page_size |
int |
每页行数，默认为20，最大支持2000 |
请求示例：
curl -H "Access-Token:d198a850da67a16279e30" \ -H "Content-Type:application/json" \ -d '
{ "start_date": "2018-12-20", "end_date": "2018-12-23", "advertiser_id": 486, "temporal_granularity": "DAILY", "page_size": 2, "page": 1 } ' https://ad.e.kuaishou.com/rest/openapi/v1/report/account_report |
2） 返回快手短视频广告主数据
字段 |
类型 |
描述 |
code |
int |
返回码/错误码 |
message |
string |
返回信息/错误信息 |
data |
JSON |
|
total_count |
int |
数据的总行数 |
details |
JSON |
数据明细信息 |
stat_date |
string |
数据日期，格式：YYYY-MM-DD |
stat_hour |
int |
数据小时 |
charge |
double |
花费（元） |
show |
long |
封面曝光数 |
photo_click |
long |
封面点击数 |
aclick |
long |
素材曝光数 |
bclick |
long |
行为数 |
photo_click_ratio |
double |
封面点击率 |
play_3s_ratio |
double |
3s播放率 |
action_ratio |
double |
行为率 |
impression_1k_cost |
double |
平均千次曝光花费（元） |
photo_click_cost |
double |
平均点击单价（元） |
action_cost |
double |
平均行为单价（元） |
share |
long |
分享数 |
comment |
long |
评论数 |
like |
long |
点赞数 |
follow |
long |
新增关注数 |
cancel_follow |
long |
取消关注数 |
report |
long |
举报数 |
block |
long |
拉黑数 |
negative |
long |
减少此类作品数 |
submit |
long |
提交按钮点击数（历史字段，同下方“表单提交数”，预计年底删除该字段） |
download_started |
long |
应用下载数据-安卓下载开始数 |
download_completed |
long |
应用下载数据-安卓下载完成数 |
activation |
long |
应用下载数据-激活数 |
event_pay_first_day |
long |
应用下载数据-首日付费次数 |
event_pay_purchase_amount_first_day |
double |
应用下载数据-首日付费金额 |
event_pay_first_day_roi |
double |
应用下载数据-首日ROI |
event_pay |
long |
应用下载数据-付费次数 |
event_pay_purchase_amount |
double |
应用下载数据-付费金额 |
event_pay_roi |
double |
应用下载数据-ROI |
event_register |
long |
应用下载数据-注册数 |
event_register_cost |
double |
应用下载数据-注册成本 |
event_register_ratio |
double |
应用下载数据-注册率 |
event_jin_jian_app |
long |
应用下载数据-完件数 |
event_jin_jian_app_cost |
double |
应用下载数据-完件成本 |
event_credit_grant_app |
long |
应用下载数据-授信数 |
event_credit_grant_app_cost |
double |
应用下载数据-授信成本 |
event_credit_grant_app_ratio |
double |
应用下载数据-授信率 |
event_order_paid |
long |
应用下载数据-付款成功数 |
event_order_paid_purchase_amount |
double |
应用下载数据-付款成功金额 |
event_order_paid_cost |
double |
应用下载数据-单次付款成本 |
event_next_day_stay |
long |
应用下载数据-次留数（仅支持分日查询） |
event_next_day_stay_cost |
double |
应用下载数据-次留成本（仅支持分日查询） |
event_next_day_stay_ratio |
double |
应用下载数据-次留率（仅支持分日查询） |
form_count |
long |
落地页数据-表单提交数 |
form_cost |
double |
落地页数据-表单提交单价 |
form_action_ratio |
double |
落地页数据-表单提交点击率 |
event_jin_jian_landing_page |
long |
落地页数据-落地页完件数 |
event_jin_jian_landing_page_cost |
double |
落地页数据-落地页完件成本 |
event_credit_grant_landing_page |
long |
落地页数据-落地页授信数 |
event_credit_grant_landing_page_cost |
double |
落地页数据-落地页授信成本 |
event_credit_grant_landing_page_cost |
double |
落地页数据-落地页授信率 |
event_valid_clues |
long |
落地页数据-有效线索数 |
event_valid_clues_cost |
double |
落地页数据-有效线索成本 |
event_add_wechat |
long |
微信复制数 |
event_add_wechat_cost |
double |
微信复制成本 |
event_add_wechat_ratio |
double |
微信复制率 |
返回样例：
{ "code": 0, "message": "OK", "data": { "total_count": 1, "details": [ { "charge": 76.0, "show": 10, "aclick": 20, "bclick": 10, "share": 3, "comment": 4, "like": 5, "follow": 2, "report": 0, "block": 0, "negative": 0, "activation": 10, "submit": 20, "cancel_follow": 0, "download_started": 0, "download_completed": 0, "stat_date": "2019-08-23", "stat_hour": 0, "photo_click": 5, "photo_click_ratio": 0.5, "action_ratio": 0.5, "impression_1k_cost": 7600.0, "photo_click_cost": 15.2, "action_cost": 7.6, "event_pay_first_day": 3, "event_pay_purchase_amount_first_day": 50.0, "event_pay_first_day_roi": 0.6578947368421053, "event_pay": 6, "event_pay_purchase_amount": 100.0, "event_pay_roi": 1.3157894736842106, "event_register": 8, "event_register_cost": 9.5, "event_register_ratio": 0.8, "event_jin_jian_app": 8, "event_jin_jian_app_cost": 9.5, "event_credit_grant_app": 6, "event_credit_grant_app_cost": 12.666666666666666, "event_credit_grant_app_ratio": 0.75, "event_order_paid": 6, "event_order_paid_purchase_amount": 100.0, "event_order_paid_cost": 12.666666666666666, "form_count": 20, "form_cost": 3.8, "form_action_ratio": 2.0, "event_jin_jian_landing_page": 8, "event_jin_jian_landing_page_cost": 9.5, "event_credit_grant_landing_page": 6, "event_credit_grant_landing_page_cost": 12.666666666666666, "event_credit_grant_landing_ratio": 0.75 } ] } } |
