report/demand-comparison

字段和值参考 · Markdown

curl -X GET "https://provisioning.cloudx.io/api/v1/report/demand-comparison?start_time=1712462400&end_time=1713067200" \
  -H "Authorization: Bearer $CLOUDX_API_KEY"

Responses

{
  "rows": [
    {
      "cloudx_revenue": 12.34,
      "partner_revenue": 12.34,
      "revenue_delta": 12.34,
      "revenue_delta_percent": 12.34,
      "cloudx_ecpm": 12.34,
      "partner_ecpm": 12.34,
      "ecpm_delta": 12.34,
      "ecpm_delta_percent": 12.34,
      "cloudx_impressions": 12.34,
      "partner_impressions": 12.34,
      "impression_delta": 12.34,
      "impression_delta_percent": 12.34,
      "demand_source": "<string>",
      "status": "comparable",
      "matched_ad_units": 12.34,
      "cloudx_ad_units": 12.34,
      "has_mapping_gaps": true,
      "partner_latest_report_date": "<string>",
      "partner_report_days": 12.34
    }
  ],
  "row_count": 123
}

需求对比汇总参考

该端点按需求方来源汇总完整请求日历日期窗口。它不提供 day、country、platform、mediator 或原始需求方报表行。CloudX 确认值是 CloudX 报表事实。需求方值来自选定需求方报表。

start_time 和 end_time 是必填 Unix 秒。CloudX 在 timezone 中将每个时间戳转换成日历日期。timezone 是 IANA 时区，默认 UTC。转换后的窗口包含端点。起始日期不得早于 2020-01-01，结束日期不得早于起始日期。在可用历史数据范围内，可选择任意长度的已结束日历日期窗口。UTC 12:00 或之后，最近的已结束日期是昨天；UTC 12:00 之前是前天。时区转换只选择日期，不会重新分桶需求方事实。请求的日期可能没有 CloudX 或需求方数据。

demand_source 可选。省略时包含所有受支持来源，也可重复传入最多五个唯一值。完整枚举为 digitalturbine、inmobi、liftoff、meta 和 moloco。provider_business_id、provider_property_id 和 cloudx_ad_unit_id 是可选逗号分隔过滤器。它们接受实时需求方或 CloudX ID，不是封闭枚举。需求方 ID 标识需求方账号或资产。CloudX ID 标识 CloudX 广告单元。

响应包含 rows 和 row_count。row_count 是返回来源行数。每个受支持来源最多出现一次。

每一行都有以下 CloudX 指标：

下列需求方和差异字段只有在该行有需求方数据时才是数字。字段缺失表示不可用，不表示零。comparable 确认已映射报表日期覆盖请求窗口，不保证每个指标均可用。需求方可以隐藏低流量切片的收入。

JSON 示例

{
  "rows": [{"cloudx_revenue": 14.25, "partner_revenue": 13.9, "revenue_delta": 0.35, "revenue_delta_percent": 2.5179856115107913, "cloudx_ecpm": 11.875, "partner_ecpm": 11.583333333333334, "ecpm_delta": 0.2916666666666661, "ecpm_delta_percent": 2.5179856115107864, "cloudx_impressions": 1200, "partner_impressions": 1200, "impression_delta": 0, "impression_delta_percent": 0, "demand_source": "meta", "status": "comparable", "matched_ad_units": 2, "cloudx_ad_units": 2, "has_mapping_gaps": false, "partner_latest_report_date": "2026-04-01", "partner_report_days": 1}],
  "row_count": 1
}