更新日志

CloudX API 发布历史

报表 API 为 GET /report/dashboard、GET /report/apps、GET /report/ad-units、GET /report/bidders、GET /report/breakdown 和 GET /report/ab-test 新增可选的 timezone 查询参数。请使用 America/New_York 等 IANA 时区名称。省略此参数时，UTC 行为和现有响应格式保持不变。

start_time 和 end_time 始终为以秒为单位的绝对 Unix 时间戳，不会再次偏移。按日历日期查询时，调用方必须先将本地日期边界转换为这些时间戳；CLI 0.41 可通过 --timezone 完成转换。控制台和拆分报表的日历分桶随后使用所选时区。控制台的 date 及日、周、月标签使用本地日期；bucket_start 和小时拆分键仍为 UTC RFC 3339 时间戳，以区分夏令时切换时重复出现的小时。

不支持的时区返回 400 Bad Request。SDK 报表、按小时分桶的控制台及拆分报表、以及按竞价方拆分的报表，均要求整个请求窗口内的时区偏移为整小时。A/B 报表仅支持 UTC。现有日期范围限制、导出行为，以及需求对比的时区和完成规则保持不变。

2026-10-09

广告网络报表路径

GET /reports/network 已迁移至 GET /report/network。该端点现与其他报表端点一同位于 /report/* 下。参数、响应和 reports:read 权限均保持不变。

破坏性变更

GET /reports/network 现在返回 404 Not Found。 旧路径不提供别名或重定向。请将所有调用更新为 GET /report/network。

2026-09-30

需求对比日期范围

两个需求对比端点现在都接受可用历史数据范围内任意长度的包含端点的日历日期窗口。起始日期不得早于 2020-01-01。结束日期必须符合 UTC 12:00 截止规则。部分请求日期可能没有 CloudX 或需求方数据。其他报表端点仍保留原有日期范围限制。

2026-09-15

需求对比报表

公共 API 现已为具有 reports:read 权限的账号提供需求对比汇总与广告单元报表。

GET /report/demand-comparison 对比 CloudX 与需求方的收入、eCPM 和展示数，并返回已匹配的 CloudX 广告单元、映射缺口和需求方报表时效信息。
GET /report/demand-comparison/ad-units 默认返回已映射的需求方聚合结果。设置 view=unmapped 可返回因映射缺失或不明确而被排除的需求方行，以及 excluded_partner_revenue 和 excluded_partner_impressions。
需求方来源过滤器使用重复查询参数。需求方业务、需求方资产和 CloudX 广告单元过滤器接受逗号分隔的多个值。
最近的已结束日期在 UTC 12:00 发生变化。

阅读 CLI 报表指南 →

2026-09-14

竞价方拆分报表

GET /report/breakdown 支持将 bidder 作为 by 维度，适用于 2026 年 6 月 1 日或之后开始的时间段。可将其与 app、format 和 ad_unit 组合，以获取竞价方级别的竞价请求、填充、展示、收入、点击和比率。requests 仍表示广告请求数，并会在竞价方行中重复；请使用 bid_requests 查看发送给每个竞价方的请求数。

2026-08-12

活动导出

公共 API 现已支持异步导出全天的展示、请求和出价活动。

新增

统一导出端点 — 通过 POST /export/impressions、POST /export/requests 和 POST /export/bids 创建或复用导出，再轮询对应的 GET 端点以获取状态和短期有效的下载 URL。
请求与出价活动 — 请求导出包含竞价结果和竞价方漏斗字段。出价导出包含出价、未出价、超时和错误记录，落败价格会被隐去。请求导出文档 → 出价导出文档 →

报表端点 — 获取控制台摘要、拆分行、竞价方表现、应用表现、广告单元表现和 CSV 风格导出。
竞价检查端点 — 检查竞价、轮次、出价、ILRD 行以及相关投放明细。
配置端点 — 读取账号的实时、草稿和已发布配置，包括配置历史。

更新日志

2026-10-13

报表时区参数