跳转到主要内容

​
示例

下列示例使用 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

​
提问技巧

  • 尽量每次工具调用只提一个报表问题
  • 使用 April 15, 2026 这样的确切日期，而非 last week
  • 需要精准答案时指定 country、device_os 与 test_mode
  • 需要数据行而非叙述性汇总时使用 GetReportExport
  • 需要快速整体健康检查时优先使用 GetReportDashboard
  • 关于 CloudX 安装、配置或功能行为的问题，优先使用 SearchDocs

​
相关链接