跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt

Use this file to discover all available pages before exploring further.

​
报表

可用命令：
  • cloudx report dashboard 用于汇总与每日指标
  • cloudx report bidders 用于竞价方表现
  • cloudx report apps 用于应用表现
  • cloudx report ad-units 用于广告单元表现
  • cloudx report export 用于 CSV 或 JSON 导出

​
通用标志

报表命令共用一组通用标志。
标志必填说明
--period否时间范围，默认为 today。支持 today、yesterday、last_7d、last_30d、YYYY-MM-DD，或 YYYY-MM-DD..YYYY-MM-DD。
--test-mode否测试流量过滤。允许的值：production、test、all。默认值：production。
--app否应用 bundle 过滤。仅 report ad-units 支持。
--ad-unit-type否广告单元类型过滤。仅 report ad-units 支持。允许的值：BANNER、INTERSTITIAL、REWARDED、MREC、NATIVE。
--country否ISO-2 国家代码，例如 US 或 GB。
--device-os否设备平台过滤。允许的值：iOS、Android。
--json否输出结构化 JSON 而非人类可读格式。

​
各命令支持的标志

标志DashboardBiddersAppsAd UnitsExport
--period✅✅✅✅✅
--test-mode✅✅✅✅❌
--app❌❌❌✅❌
--ad-unit-type❌❌❌✅❌
--country✅✅✅✅✅
--device-os✅✅✅✅✅
--json✅✅✅✅✅

​
时间段值

时间段解析基于 UTC。 省略 --period 时，所有报表命令都使用 today。
值含义
today当前 UTC 当日
yesterday前一个 UTC 当日
last_7d当前 UTC 当日加上前 6 天
last_30d当前 UTC 当日加上前 29 天
2026-04-01单个 UTC 日期
2026-04-01..2026-04-07含端点的 UTC 日期范围
校验规则：
  • 结束日期不得早于起始日期。
  • --country 必须为规范化后的两位大写 ISO-2 国家代码。
  • --device-os 必须严格为 iOS 或 Android。
  • --test-mode 必须为 production、test 或 all。

​
输出格式

​
人类可读格式

大多数命令会先输出一段元信息块，再输出表格。 元信息块示例： 
Period:      last_30d
Test mode:   production
Country:     US
Device OS:   iOS

​
JSON

传入 --json 以返回结构化 JSON： 
cloudx report dashboard --json
所有命令示例汇总在 示例 页面。

​
cloudx report dashboard

显示汇总指标与每日图表行。

​
用法

cloudx report dashboard [--period <value>] [flags]

​
示例

$ cloudx report dashboard
Period:      today
Test mode:   production

Requests:     1.5M
Impressions:  1.2M
Revenue:      $14.9K
Fill Rate:    78.0%
eCPM:         $12.7
Clicks:       35.1K
CTR:          3.0%
Users:        42K

DATE        REQUESTS  IMPRESSIONS  REVENUE  CLICKS
2026-03-29  210K      163.8K       $2.1K    4.9K

​
cloudx report bidders

显示所选时间段内的竞价方级别表现。

​
用法

cloudx report bidders [--period <value>] [flags]

​
示例

$ cloudx report bidders
Period:      today
Test mode:   production

BIDDER  REQUESTS  BIDS  BID RATE  IMPRESSIONS  WIN RATE  REVENUE  ECPM
meta    850K      629K  74.0%     314.5K       50.0%     $5.6K    $17.7

​
cloudx report apps

显示所选时间段内的应用级表现。

​
用法

cloudx report apps [--period <value>] [flags]

​
示例

$ cloudx report apps
Period:      today
Test mode:   production

APP ID            NAME          PLATFORM  IMPRESSIONS  FILL RATE  REVENUE  ECPM
com.example.game  Example Game  iOS       1.8M         78.0%      $8.4K    $4.7

​
cloudx report ad-units

显示所选时间段内的广告单元级表现。

​
用法

cloudx report ad-units [--period <value>] [flags]
这是当前唯一同时支持 --app 与 --ad-unit-type 的报表命令。

​
示例

$ cloudx report ad-units
Period:      today
Test mode:   production

AD UNIT ID  NAME                APP NAME      APP BUNDLE        TYPE    IMPRESSIONS  FILL RATE  REVENUE  ECPM
abc123      Home Screen Banner  Example Game  com.example.game  BANNER  450K         55.0%      $2.1K    $4.7

​
cloudx report export

默认以 CSV 格式导出报表数据。

​
用法

cloudx report export [--period <value>] [flags]

​
示例

$ cloudx report export
date,network_name,country
2026-03-29,meta,US

​
JSON 输出

使用 --json 时，响应中包含：
  • columns
  • rows
  • row_count

​
相关链接