跳转到主要内容

​
竞价检查

cloudx auction 命令用于检查竞价记录、轮次、出价与未出价行、CloudX ILRD，以及已启用的外部聚合平台 ILRD。 可用命令：
  • cloudx auction list：列出符合过滤条件的近期竞价
  • cloudx auction show：查看单次竞价及可选关联部分
  • cloudx auction rounds：查看单次竞价的轮次，或聚合轮次指标
  • cloudx auction bids：列出符合过滤条件的出价与未出价行

​
共享标志

这些标志由 list、rounds 和 bids 共享。
标志必需默认值说明
--period否today竞价时间范围。支持 today、yesterday、last_7d、last_30d、YYYY-MM-DD 或 YYYY-MM-DD..YYYY-MM-DD。
--test-mode否production库存模式过滤。允许的值：production、test、all。
--app否应用 bundle 过滤，例如 com.example.game。
--ad-unit-id否CloudX 广告单元 ID 过滤。
--country否ISO-3166-1 alpha-2 国家代码过滤，例如 US 或 GB。
--device-os否设备 OS 过滤。允许的值：iOS、Android。
--limit否50最多返回行数。必须介于 0 和 500 之间。
--json否false输出结构化 JSON，而不是人类可读输出。
时间段解析基于 UTC。省略 --period 时，命令使用 today。

​
cloudx auction list

列出符合请求过滤条件的近期竞价。

​
用法

cloudx auction list [flags]

​
附加标志

标志必需说明
--has-ilrd否仅显示包含 CloudX ILRD 的竞价。
--has-external-ilrd否仅显示包含外部聚合平台 ILRD 的竞价。
--mediator否外部聚合平台过滤。允许的值：applovin、admob、levelplay。需要配合 --has-external-ilrd 使用。
验证规则：
  • --has-ilrd 和 --has-external-ilrd 不能同时使用。
  • --mediator 需要配合 --has-external-ilrd 使用。

​
示例

cloudx auction list --period today --test-mode all
cloudx auction list --period last_7d --limit 10
cloudx auction list --period yesterday --has-ilrd
cloudx auction list --period today --has-external-ilrd --mediator applovin
cloudx auction list --app com.example.game --ad-unit-id adunit_interstitial_1 --country GB --device-os Android
cloudx auction list --period 2026-04-30..2026-05-01 --json

​
cloudx auction show

显示单次竞价。使用 --with 可在同一响应中包含关联行。

​
用法

cloudx auction show <id> [flags]

​
标志

标志必需说明
--with否逗号分隔的可选部分。允许的值：rounds、bids、ilrd、external-ilrd。
--json否输出结构化 JSON，而不是人类可读输出。

​
示例

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

​
cloudx auction rounds

检查单次竞价的轮次，或跨过滤后的竞价聚合轮次指标。 设置 --auction-id 时，命令返回该竞价的轮次。省略 --auction-id 时，命令按请求的时间段和过滤条件返回聚合指标。

​
用法

cloudx auction rounds [flags]

​
附加标志

标志必需默认值说明
--auction-id否要检查的竞价 ID。设置后，服务端会忽略过滤器和指标聚合。
--metric否distribution省略 --auction-id 时使用的聚合指标。允许的值：distribution、duration、cleared-on、skip-reason。

​
示例

cloudx auction rounds --auction-id auc_123
cloudx auction rounds --auction-id auc_123 --json
cloudx auction rounds --period today --metric distribution --test-mode all
cloudx auction rounds --period today --metric duration --app com.example.game --country US --device-os iOS
cloudx auction rounds --period yesterday --metric skip-reason --limit 20 --json

​
cloudx auction bids

列出符合请求过滤条件的出价与未出价行。

​
用法

cloudx auction bids [flags]

​
附加标志

标志必需说明
--floor-source否生效底价来源过滤。允许的值：static、dynamic、publisher、configured。

​
示例

cloudx auction bids --period today --test-mode all
cloudx auction bids --period today --floor-source dynamic
cloudx auction bids --period today --floor-source static
cloudx auction bids --period yesterday --floor-source configured --test-mode all
cloudx auction bids --period today --floor-source publisher --country US --json

​
输出格式

默认情况下，竞价命令会面向交互式终端打印人类可读的元数据与表格。传入 --json 可为脚本和下游分析返回结构化数据。 
cloudx auction list --period last_7d --json
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json

​
相关链接