Skip to main content

示例

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

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

提问:
工具调用:
预期返回:
  • summary 对象,包含合计与衍生 KPI
  • chart_data 数组,包含所选周期的每日行

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

提问:
工具调用:
常见字段:
  • name
  • requests
  • bids
  • bid_rate
  • impressions
  • win_rate
  • revenue
  • ecpm

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

提问:
工具调用:
当您已知应用 bundle 或只关心一种广告格式时,使用此模式。

示例 4:导出数据用于分析

提问:
工具调用:
该工具返回的 JSON 结构包括:
  • columns
  • rows
  • row_count

示例 5:检索 CloudX 文档

提问:
工具调用:
该工具返回匹配的文档页面,包含:
  • content
  • path
  • url
  • metadata

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

响应会标明请求的 dimensionsmetrics,然后在 rows 中返回分组值。

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

首先查找近期竞价:
再将结果中的 auction_id 传给 GetAuctionShow
如需聚合轮次指标,使用 GetAuctionRounds;如需跨多次竞价检索出价行,使用 GetAuctionBids

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

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

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

先使用 GetConfigShow 检查线上配置并获取资源 ID。以下示例在草稿中修改一个广告单元的底价:
普通编辑会返回草稿 id 与验证结果。可以直接检查该草稿:
确认后再发布:
发布会更改账户的线上配置。请使用 PostConfigEdit 实际返回的草稿 ID,并在发布前确认验证结果。

提问技巧

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

相关链接