【注意事项】快手广告计划/快手广告组/快手广告创意报表查询接口,如果单次查询,需要处理的有效快手广告计划/快手广告组/快手广告创意数量超过5000,会提示“报表查询处理ID数比较多,请分批次传ID进行查询”。其中,“有效广告计划/广告组/广告创意数量”以请求的实际结果为准,并非快手账户里广告计划/广告组/广告创意的整体数量。
为了保证更稳定、更高效的报表数据查询,现新增历史投放报表数据接口,支持以异步任务的方式查询历史数据。原有的实时报表接口时间范围调整为近7天(含当天),历史投放报表接口时间范围为近12个月(含当天);分时查询仅支持近7天(含当天)的数据。由于投放后台可查询时间范围近期有变动,Marketing API会尽快对齐。

一、新增权限code
report_service(获取快手广告账户报表信息)
需要在授权URL的scope参数上添加 report_service,进行授权后才能访问获取快手信息流广告账户报表信息的接口,示例如下:
二、报表查询
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 |
(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 | 微信复制率 |
湖北老河口广告开户代理商/快手信息流开户流程,湖北应城市快手广告首冲多少钱/应城快手广告代理,湖北石首快手信息流广告和视频广告都是找巨宣网络!湖北武穴怎么做快手广告,武学快手推广开户首充多少?湖北仙桃有做快手开户的吗?快手广告开户找《巨宣网络》,湖南醴陵怎么投放快手广告,醴陵投放快手一般多少钱?湖南常宁快手短视频广告投放/常德快手广告开户代理!湖南津市快手广告可以投放直播吗?快手短视频广告开户!湖南冷水江快手广告推广在哪里?冷水江快手广告怎么做?
- 2026-03-27
快手广告 | 一键拆解爆款素材基因 - 2026-03-24
快手广告|商家38上新季生意爆发,多维拆解… - 2026-03-24
快手磁力引擎广告 | 对谈36氪,AI下凡驱动… - 2026-03-17
快手品牌广告如何代投实现GMV倍增? - 2026-03-16
快手广告功能更新 | 活动复盘大场活动 - 2026-03-16
快手广告丨磁力方舟「人群智能推荐」+「AI… - 2026-03-11
快手磁力方舟广告平台【AI智能复盘】,全新… - 2026-03-07
2026年快手广告短剧行业春节档营销新趋势 - 2026-03-04
快手磁力引擎广告2026体育营销招商手册上新… - 2026-03-03
快手商业私信广告案例库(10)




















管理员
该内容暂无评论