跳转到主要内容

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 CLI 的实用示例。 命令详情与标志支持,请参见 报表命令竞价检查配置

报表基础

默认查看当日控制台汇总

cloudx report dashboard

按国家与设备 OS 过滤的控制台汇总

cloudx report dashboard --period last_7d --country US --device-os iOS

查看 CloudX 与外部聚合平台的控制台汇总

cloudx report dashboard --period last_7d --source all

按 UTC 小时查看控制台图表

cloudx report dashboard --period 2026-04-01 --granularity hourly

自定义日期范围的控制台 JSON 输出

cloudx report dashboard --period 2026-04-01..2026-04-07 --json

为较重报表设置更长超时

cloudx --timeout 90s report export --period 2026-04-01..2026-04-07

拆分报表

按日期和国家查看收入与 eCPM

cloudx report breakdown --period last_7d --by day,country --metrics revenue,impressions,ecpm

按小时和应用查看填充率

cloudx report breakdown --period 2026-04-01 --granularity hourly --by hour,app --metrics requests,impressions,fill_rate

按收入查看 Top 广告单元

cloudx report breakdown --by app,ad_unit --metrics revenue,ecpm --top 10

使用指标过滤并输出 JSON

cloudx report breakdown --by country --metrics revenue,impressions --having 'revenue > 10' --json

竞价方报表

默认查看当日竞价方表现

cloudx report bidders

同时包含生产流量与测试流量

cloudx report bidders --period last_30d --test-mode all --country US

以 JSON 输出竞价方报表

cloudx report bidders --period yesterday --json

应用报表

默认查看当日应用表现

cloudx report apps

按设备 OS 过滤

cloudx report apps --period last_30d --device-os Android

按应用对比 CloudX 与 AppLovin

cloudx report apps --period last_30d --source cloudx,applovin

单日应用报表的 JSON 输出

cloudx report apps --period 2026-04-01 --json

广告单元报表

默认查看当日广告单元表现

cloudx report ad-units

按应用与广告单元类型过滤

cloudx report ad-units --app com.example.game --ad-unit-type BANNER

查看单个应用广告单元的外部聚合平台 ILRD

cloudx report ad-units --app com.example.game --source all

以 JSON 输出广告单元报表

cloudx report ad-units --period last_7d --country US --device-os iOS --json

导出

将当日数据以 CSV 导出至标准输出

cloudx report export

按国家与设备 OS 过滤后以 CSV 导出

cloudx report export --period last_30d --country US --device-os iOS

按 UTC 小时分桶导出 CSV

cloudx report export --period 2026-04-01 --granularity hourly

以 JSON 而非 CSV 导出

cloudx report export --period 2026-04-01..2026-04-07 --json

将 CSV 保存到文件

cloudx report export --period last_7d > report.csv

竞价检查

列出当日竞价

cloudx auction list --period today --test-mode all

列出包含 CloudX ILRD 的竞价

cloudx auction list --period yesterday --has-ilrd

列出包含外部聚合平台 ILRD 的竞价

cloudx auction list --period today --has-external-ilrd --mediator applovin

按库存与设备过滤竞价

cloudx auction list --period today --app com.example.game --ad-unit-id adunit_interstitial_1 --country GB --device-os Android --limit 10

显示单次竞价及关联行

cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json

检查单次竞价的轮次

cloudx auction rounds --auction-id auc_123

聚合轮次指标

cloudx auction rounds --period today --metric skip-reason --test-mode all

按生效底价来源列出出价

cloudx auction bids --period today --floor-source dynamic --country US --json

配置

显示实时配置

cloudx config show

显示已发布配置版本

cloudx config show --version 12

显示带元数据的配置草稿

cloudx config show --draft --with-metadata

以 JSON 输出原始配置数据

cloudx config show --id cfg_123 --json

验证本地配置文件

cloudx config validate config.yaml

以 JSON 验证草稿

cloudx config validate --id draft_123 --json

创建草稿订单项

cloudx config edit create-line-item \
  --name "美国激励视频" \
  --priority 2 \
  --bidfloor 1.5 \
  --ad-unit-id au_123 \
  --bidder meta \
  --bidder unityAds

暂停订单项

cloudx config edit update-line-item --id li_123 --status paused

修改订单项底价并在有警告时失败

cloudx config edit update-line-item --id li_123 --bidfloor 1.5 --strict

从草稿中删除订单项

cloudx config edit delete-line-item --id li_123 --summary "删除旧激励视频订单项"

发布配置草稿

cloudx config publish --id draft_123 --version-label "5 月底价更新"

调整竞价底价并发布

cloudx config edit update-line-item --id li_123 --bidfloor 1.5 --summary "提高美国激励视频底价"
cloudx config validate --id draft_123
cloudx config publish --id draft_123 --version-label "提高美国激励视频底价"

组合工作流

cloudx report dashboard
cloudx report breakdown --period last_7d --by day,country --metrics revenue,impressions,ecpm
cloudx report bidders --period last_7d --country US
cloudx report apps --period last_7d --source cloudx,applovin
cloudx report ad-units --app com.example.game --source all
cloudx report export --period last_7d > report.csv
cloudx config validate config.yaml --strict
cloudx config edit update-line-item --id li_123 --bidfloor 1.5
cloudx config publish --id draft_123 --version-label "提高美国激励视频底价"

相关链接