跳转到主要内容

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.

[0.32] - 2026-05-13

要将现有的 Homebrew 安装升级到此版本:
brew upgrade cloudx

新增

  • API Key 认证 — 支持通过 CLOUDX_API_KEY 在 CI、定时任务、脚本以及其他非交互式工作流中认证 CLI。API Key 由管理员在 Settings > API Keys 中管理。阅读文档 →
  • CloudX 拆分报表cloudx report breakdown --by <dimensions> --metrics <metrics> 支持按请求、展示、收入、填充率、eCPM、点击和 CTR 查询 CloudX-only 聚合报表。
  • 报表粒度与控制cloudx report dashboardcloudx report export 支持 --granularity daily|hourly;拆分报表可通过 --granularity hourly--top--bottom--having 使用小时分桶、排序和过滤。
  • 可配置请求超时 — 全局 cloudx --timeout <duration> 可设置 API 请求超时。默认仍为 1m,最大 2m阅读文档 →

[0.31] - 2026-05-07

跨聚合平台报表来源

CloudX CLI 0.31 为已转发展示级收入数据的 publisher 增加报表来源过滤。现有报表命令默认仍然只统计 CloudX;在支持的命令中,可以使用 --source 显式纳入外部聚合平台 ILRD。 要将现有的 Homebrew 安装升级到此版本:
brew upgrade cloudx

新增

  • 报表来源过滤 — 为 cloudx report dashboardcloudx report appscloudx report ad-units 增加 --source。使用 --source all 查看 CloudX 加所有可用外部聚合平台来源,使用 --source applovin 查看单一聚合平台,或使用 --source cloudx,applovin 进行并排对比。
  • 按来源统计的报表指标 — Dashboard、应用与广告单元报表现在可以纳入外部聚合平台 ILRD,用于收入、展示、eCPM 与收入占比。包含外部聚合平台时,填充率仍然只代表 CloudX,因为外部 ILRD 不包含 CloudX 请求数。
  • 更清晰的来源语义--source 使用 ILRD 中的聚合平台/平台来源,例如 applovin,而不是 ADMOB_BIDDING 等下游需求方网络名称。阅读文档 →

[0.30] - 2026-05-06

竞价列表性能与超时处理

CloudX CLI 0.30 重点提升较重查询下的竞价检查可靠性,并让超时失败更容易理解。 要将现有的 Homebrew 安装升级到此版本:
brew upgrade cloudx

改进

  • 使用 ILRD 过滤时竞价列表更快 — 改进 cloudx auction list 在 ILRD 较多的查询中的性能,尤其是在按外部 ILRD 和聚合平台缩小结果范围时。
  • 更长的默认请求超时时间 — 将 CLI 默认超时时间增加到 60 秒,让较重的请求有更多时间完成。
  • 更清晰的超时错误 — 发生超时时,CLI 现在会显示更清晰的提示,而不是底层网络错误。
  • 更好的超时可见性 — CloudX 支持团队现在可以更容易识别和诊断超时的 CLI 请求。

[0.29] - 2026-05-05

竞价与配置检查

CloudX CLI 0.29 将终端工作流从报表扩展到生产问题排查。现在无需切换到控制台,即可检查竞价、轮次、出价、ILRD 载荷、实时配置、草稿以及已发布配置历史。 要将现有的 Homebrew 安装升级到此版本:
brew upgrade cloudx

新增

  • 竞价检查 — 新增 cloudx auction listcloudx auction showcloudx auction roundscloudx auction bids,用于查看竞价记录、关联行、轮次聚合指标、出价与未出价行、底价来源、CloudX ILRD,以及已启用的外部聚合平台 ILRD。阅读文档 →
  • 配置检查 — 新增 cloudx config show,支持查看实时配置、已发布版本、草稿以及通过 ID 指定的配置行;默认输出 YAML,也可通过 JSON 输出用于自动化流程。阅读文档 →
  • 配置历史 — 新增 cloudx config history,支持查看已发布配置历史、按创建者过滤、按最近变更过滤、包含草稿,以及查看发布时的差异摘要。
  • 工作流示例 — 更新 CLI 示例与概览页面,覆盖竞价、配置、JSON 以及报表组合工作流。查看示例 →

2026-04-22

在终端里使用 CloudX

CLI dashboard report 并非每个问题都需要打开浏览器。全新的 CloudX CLI 让您的日常数据只在一行命令之间——运行 cloudx report dashboard 即可在命令行中看到收入、填充率、eCPM 与趋势。按国家、平台、广告单元或测试流量过滤,方式与控制台完全一致。 需要将数据用于下游分析时,使用 --json 输出结构化 JSON,或使用 cloudx report export 导出 CSV,直接送入电子表格、Notebook 或其他工具。通过 brew install cloudx 安装,登录一次,您的报表工作流便能随您在任何工作环境中使用。阅读文档 →