更新日志

CloudX API 发布历史

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 广告单元过滤器接受逗号分隔的多个值。
报表时间范围最多包含 31 个已结束的日历日期。最近的已结束日期在 UTC 12:00 发生变化。

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。
请求与出价活动 — 请求导出包含竞价结果和竞价方漏斗字段。出价导出包含出价、未出价、超时和错误记录，落败价格会被隐去。请求导出文档 → 出价导出文档 →