概览AndroidiOSUnityReact NativeFlutterCLIAPIMCP需求广告格式Dashboard更新日志

示例

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

示例

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

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

提问：

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.

工具调用：

{
  "name": "GetReportDashboard",
  "arguments": {
    "start_time": 1776211200,
    "end_time": 1776815999,
    "country": "US",
    "device_os": "iOS",
    "test_mode": "production"
  }
}

预期返回：

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

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

提问：

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.

工具调用：

{
  "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 广告位

提问：

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.

工具调用：

{
  "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：导出数据用于分析

提问：

Export CloudX report rows for US Android traffic from April 1, 2026 through April 7, 2026 so I can inspect the raw table structure.

工具调用：

{
  "name": "GetReportExport",
  "arguments": {
    "start_time": 1775001600,
    "end_time": 1775606399,
    "country": "US",
    "device_os": "Android"
  }
}

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

  • columns
  • rows
  • row_count

示例 5：检索 CloudX 文档

提问：

Find CloudX docs about report filters and summarize which filters are available.

工具调用：

{
  "name": "SearchDocs",
  "arguments": {
    "body": {
      "query": "report filters"
    }
  }
}

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

  • content
  • path
  • url
  • metadata

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

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

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

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

首先查找近期竞价：

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

再将结果中的 auction_id 传给 GetAuctionShow：

{
  "name": "GetAuctionShow",
  "arguments": {
    "auction_id": "auction_123",
    "with": "rounds,bids,ilrd,external-ilrd"
  }
}

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

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

{
  "name": "GetReportABTest",
  "arguments": {
    "ab_test_id": "abtest_123",
    "start_time": 1776211200,
    "end_time": 1776815999
  }
}

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

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

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

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

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

{
  "name": "GetConfigShow",
  "arguments": {
    "id": "draft_123"
  }
}

确认后再发布：

{
  "name": "PostConfigPublish",
  "arguments": {
    "body": {
      "draft_id": "draft_123",
      "version_label": "Raise the banner floor"
    }
  }
}

提问技巧

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

相关链接