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 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，而不是人类可读输出。 |
--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
相关链接
