> ## 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 命令参考，包括过滤器、输出格式、ILRD 检查、轮次指标和竞价底价分析。

# 竞价检查

`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`

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

### 用法

```bash theme={null}
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` 使用。

### 示例

```bash theme={null}
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` 可在同一响应中包含关联行。

### 用法

```bash theme={null}
cloudx auction show <id> [flags]
```

### 标志

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

### 示例

```bash theme={null}
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` 时，命令按请求的时间段和过滤条件返回聚合指标。

### 用法

```bash theme={null}
cloudx auction rounds [flags]
```

### 附加标志

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

### 示例

```bash theme={null}
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`

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

### 用法

```bash theme={null}
cloudx auction bids [flags]
```

### 附加标志

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

### 示例

```bash theme={null}
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` 可为脚本和下游分析返回结构化数据。

```bash theme={null}
cloudx auction list --period last_7d --json
cloudx auction show auc_123 --with rounds,bids,ilrd,external-ilrd --json
```

## 相关链接

* [CloudX CLI 概览](/zh/cli)
* [报表命令](/zh/cli/reporting)
* [示例](/zh/cli/examples)