> ## 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.

# 示例

> 可复制的 MCP 示例，涵盖 CloudX 报表与文档检索，包括真实参数负载与提示词模式。

# 示例

下列示例使用 CloudX MCP 暴露的真实工具名。报表示例使用准确的 UTC 时间戳。

## 示例 1：美国 iOS 流量的 Dashboard 汇总

提问：

```text theme={null}
Show me dashboard performance for US iOS production traffic from April 15, 2026 through April 21, 2026. Summarize revenue, fill rate, CTR, and daily trend.
```

工具调用：

```json theme={null}
{
  "name": "GetReportDashboard",
  "arguments": {
    "start_time": 1776211200,
    "end_time": 1776815999,
    "country": "US",
    "device_os": "iOS",
    "test_mode": "production"
  }
}
```

预期返回：

* `summary` 对象，包含合计与衍生 KPI
* `chart_data` 数组，包含所选周期的每日行

## 示例 2：对比 Android 测试流量上的竞价方

提问：

```text theme={null}
For April 15, 2026, compare bidder performance on Android test traffic in the US. Rank bidders by revenue and call out bid rate and win rate.
```

工具调用：

```json theme={null}
{
  "name": "GetReportBidders",
  "arguments": {
    "start_time": 1776211200,
    "end_time": 1776297599,
    "country": "US",
    "device_os": "Android",
    "test_mode": "test"
  }
}
```

常见字段：

* `name`
* `requests`
* `bids`
* `bid_rate`
* `impressions`
* `win_rate`
* `revenue`
* `ecpm`

## 示例 3：查看单个应用的 banner 广告位

提问：

```text theme={null}
Show banner ad unit performance for com.example.game in the US on Android for April 15, 2026. I want to find the weakest placements by fill rate.
```

工具调用：

```json theme={null}
{
  "name": "GetReportAdUnits",
  "arguments": {
    "start_time": 1776211200,
    "end_time": 1776297599,
    "country": "US",
    "device_os": "Android",
    "test_mode": "all",
    "app_bundle": "com.example.game",
    "ad_unit_type": "BANNER"
  }
}
```

当您已知应用 bundle 或只关心一种广告格式时，使用此模式。

## 示例 4：导出数据用于分析

提问：

```text theme={null}
Export CloudX report rows for US Android traffic from April 1, 2026 through April 7, 2026 so I can inspect the raw table structure.
```

工具调用：

```json theme={null}
{
  "name": "GetReportExport",
  "arguments": {
    "start_time": 1775001600,
    "end_time": 1775606399,
    "country": "US",
    "device_os": "Android"
  }
}
```

该工具返回的 JSON 结构包括：

* `columns`
* `rows`
* `row_count`

## 示例 5：检索 CloudX 文档

提问：

```text theme={null}
Find CloudX docs about report filters and summarize which filters are available.
```

工具调用：

```json theme={null}
{
  "name": "SearchDocs",
  "arguments": {
    "body": {
      "query": "report filters"
    }
  }
}
```

该工具返回匹配的文档页面，包含：

* `content`
* `path`
* `url`
* `metadata`

## 示例 6：构建自定义国家维度拆分

```json theme={null}
{
  "name": "GetReportBreakdown",
  "arguments": {
    "start_time": 1776211200,
    "end_time": 1776297599,
    "by": "country",
    "metrics": "requests,impressions,revenue",
    "test_mode": "production",
    "top": 20
  }
}
```

响应会标明请求的 `dimensions` 与 `metrics`，然后在 `rows` 中返回分组值。

## 示例 7：检查竞价及其出价

首先查找近期竞价：

```json theme={null}
{
  "name": "GetAuctionList",
  "arguments": {
    "start_time": 1776211200,
    "end_time": 1776297599,
    "app_bundle": "com.example.game",
    "has_ilrd": true,
    "limit": 10
  }
}
```

再将结果中的 `auction_id` 传给 `GetAuctionShow`：

```json theme={null}
{
  "name": "GetAuctionShow",
  "arguments": {
    "auction_id": "auction_123",
    "with": "rounds,bids,ilrd,external-ilrd"
  }
}
```

如需聚合轮次指标，使用 `GetAuctionRounds`；如需跨多次竞价检索出价行，使用 `GetAuctionBids`。

## 示例 8：检查 A/B 测试表现

```json theme={null}
{
  "name": "GetReportABTest",
  "arguments": {
    "ab_test_id": "abtest_123",
    "start_time": 1776211200,
    "end_time": 1776815999
  }
}
```

比较 `control` 与 `test` 的累计和每日指标。统计字段被省略或为 null 时，应视为尚不可用。

## 示例 9：编辑、验证与发布配置

先使用 `GetConfigShow` 检查线上配置并获取资源 ID。以下示例在草稿中修改一个广告单元的底价：

```json theme={null}
{
  "name": "PostConfigEdit",
  "arguments": {
    "body": {
      "summary": "Raise the banner floor",
      "operations": [
        {
          "update_ad_unit": [
            {
              "id": "adunit_123",
              "bidfloor": 1.5
            }
          ]
        }
      ]
    }
  }
}
```

普通编辑会返回草稿 `id` 与验证结果。可以直接检查该草稿：

```json theme={null}
{
  "name": "GetConfigShow",
  "arguments": {
    "id": "draft_123"
  }
}
```

确认后再发布：

```json theme={null}
{
  "name": "PostConfigPublish",
  "arguments": {
    "body": {
      "draft_id": "draft_123",
      "version_label": "Raise the banner floor"
    }
  }
}
```

<Warning>
  发布会更改账户的线上配置。请使用 `PostConfigEdit` 实际返回的草稿 ID，并在发布前确认验证结果。
</Warning>

## 提问技巧

* 尽量每次工具调用只提一个报表问题
* 使用 `April 15, 2026` 这样的确切日期，而非 `last week`
* 需要精准答案时指定 `country`、`device_os` 与 `test_mode`
* 需要数据行而非叙述性汇总时使用 `GetReportExport`
* 需要快速整体健康检查时优先使用 `GetReportDashboard`
* 固定报表工具无法提供所需分组时，使用 `GetReportBreakdown`
* 不知道竞价 ID 时，先使用 `GetAuctionList`，再使用 `GetAuctionShow`
* 请求客户端在调用 `PostConfigPublish` 前先显示并验证配置草稿
* 关于 CloudX 安装、配置或功能行为的问题，优先使用 `SearchDocs`

## 相关链接

* [工具参考](/zh/mcp/tools)
* [安装](/zh/mcp/installation)