更新日志 - CloudX Documentation

2026年5月28日

Android

Android SDK 4.1.2

新增

Banner 内原生渲染 - 支持的适配器（包括 Meta、Moloco 和 Vungle）的原生广告需求现在可以通过现有的 banner 公共 API 投放到标准 banner 和 MREC 广告位中。

变更

服务端驱动的”始终奖励”模式 - 激励广告适配器现在支持在 Dashboard 中按 line item 配置的 shouldAlwaysRewardUser 标志。当启用时，即使部分广告网络不一定回传奖励信号，SDK 也会触发奖励回调。发布商无需修改集成代码即可受益。

2026年5月27日

iOSUnity

iOS SDK 3.4.1

新增

Digital Turbine 适配器 — 全新的 CloudXDigitalTurbineAdapter（横幅、中矩形、插屏、激励、原生）。安装：pod 'CloudXDigitalTurbineAdapter', '~> 3.4.1'。底层基于 Fyber_Marketplace_SDK >= 8.4.0, < 9.0。

修复

横幅刷新时 didLoadAd / didShowAd 回调重复 — 当合作伙伴适配器 SDK 对同一广告多次触发加载或展示回调时，发布者委托可能收到重复的回调。现在首次回调被视为标准回调，同一适配器后续重复触发的相同事件将被丢弃，发布者侧每个广告精确收到一次加载和一次展示。

Unity SDK 4.1.0

新功能

新增 CloudXSdk.Arbiter(bids, onCompleted)，支持在 Unity 中发起 Trusted Arbiter 竞价
新增 SetBannerExtraParameter(adUnitId, key, value)、SetMRecExtraParameter(adUnitId, key, value)、SetInterstitialExtraParameter(adUnitId, key, value) 和 SetRewardedExtraParameter(adUnitId, key, value)，可为各广告格式传递网络特定参数

SDK 更新

将 Android SDK 从 4.0.0 更新至 4.1.1 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.2.0 更新至 3.4.1 — 详情请参阅 iOS SDK 更新日志
新增 Android 和 iOS 的 Moloco 和 Verve 适配器支持

2026年5月26日

Android

Android SDK 4.1.1

新增

Digital Turbine 适配器支持 - 新增对 Digital Turbine Android 适配器的 SDK 支持。适配器制品仍会独立发布。
扩展广告网络映射 - 新增 BidMachine、Chartboost、Digital Turbine、LoopMe、MobileFuse、Pangle、PubMatic 和 Yandex 的 SDK 广告网络映射，使兼容适配器在可用后能够独立发布。

变更

Digital Turbine 适配器元数据 - 更新 Digital Turbine 适配器元数据和错误报告兼容性，以配合 CloudX SDK 4.1.1。
Google Waterfall 适配器 - 将 Google Waterfall 支持更新至 Google Mobile Ads SDK 25.1.0，并在 AdMob 展示级收入回调不可用时为 banner/MREC 新增备用展示上报。

2026年5月25日

React Native

React Native SDK 3.4.0

新增

Trusted Arbiter - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
广告元数据 - 新增 CloudXAdInfo.adValues，用于读取 SDK 提供的已加载广告元数据，可用于 Trusted Arbiter 等功能。
更多适配器覆盖 - 更新 iOS 和 Android 最新支持适配器的安装说明，包括底层原生 SDK 支持的 Google Waterfall、Moloco 和 Verve。

变更

底层原生 SDK 版本更新为 iOS CloudXCore ~> 3.4.0 和 Android io.cloudx:sdk:4.1.0。

平台支持

iOS: CloudXCore ~> 3.4.0
Android: io.cloudx:sdk:4.1.0

2026年5月22日

AndroidiOS

Android SDK 4.1.0

新增

Trusted Arbiter - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
广告价值访问器 - 新增 CloudXAd.adValues，用于读取 SDK 提供的广告元数据。
扩展广告网络支持 - 新增 Google Waterfall、Moloco 和 Verve 适配器的 SDK 支持。适配器制品仍会独立发布。
MRAID 3.0 广告视图渲染 - CloudX 渲染器新增对 MRAID 3.0 banner 和 MREC 素材的支持。

iOS SDK 3.4.0

新增

Verve 适配器 — 全新的 CloudXVerveAdapter（横幅、中矩形、插屏、激励、原生）。安装：pod 'CloudXVerveAdapter', '~> 3.4.0'。底层基于 HyBid 3.8.0。
Moloco 适配器 — 全新的 CloudXMolocoAdapter（横幅、中矩形、插屏、激励、原生）。安装：pod 'CloudXMolocoAdapter', '~> 3.4.0'。底层基于 MolocoSDKiOS ~> 4.6.0。
非 SDK CloudX 渲染的 HTML 横幅与中矩形（含 MRAID 3.0） — HTML 横幅和中矩形素材现可通过 CloudX 渲染器投放，并支持 MRAID 3.0。
横幅位与中矩形位原生广告支持 — 原生素材可投放到 Meta、Vungle、Moloco 上的横幅或中矩形广告位。
Trusted Arbiter — 新增公共 API，可比较 CloudX 出价与 Unity LevelPlay、PubMatic 的受支持第三方出价，并通过 CloudX 仲裁选择获胜平台。
CLXAd.adValues 属性 — 新增只读 NSDictionary<NSString *, NSString *> 属性，暴露 SDK 定义的加载广告元数据。具体可用值取决于广告格式与网络。

变更

UnityAds 适配器版本范围放宽 — 调整为接受 Unity Ads 4.x 补丁版本(>= 4.17.0, < 5.0)。
发布方委托主队列回调成为契约文档 — 所有 CLXAdDelegate 回调（及其扩展协议）以及 CLXAdRevenueDelegate 回调都会在主队列上派发，并可能相对触发它们的 SDK 调用以内联方式触发。运行时行为无变化。

修复

长会话期间的原生广告内存泄漏 — 长期运行、加载大量原生广告的发布方集成不再在每次原生广告刷新周期累积保留观察者。

2026年5月21日

CLI

CloudX CLI 0.33

配置验证、订单项编辑与发布

CloudX CLI 0.33 现在支持直接在配置工作流中编辑订单项、发布已评审的草稿，并可验证本地 YAML 文件和远程配置。要将现有的 Homebrew 安装升级到此版本：

brew upgrade cloudx

新增

配置验证 — 新增 cloudx config validate [file]，可验证本地 YAML 文件，也可远程验证实时配置、已发布版本或按 ID 指定的草稿。使用 --strict 可在出现警告时失败。阅读文档 →
订单项写入 — 新增 cloudx config edit create-line-item、cloudx config edit update-line-item 和 cloudx config edit delete-line-item，用于在配置草稿中准备订单项改动。草稿编辑会运行验证，并且永远不会自动发布。阅读文档 →
配置发布 — 新增 cloudx config publish --id <draft-id>，用于将已验证的草稿发布为实时配置。阅读文档 →
CLI 升级提示 — 当 CloudX API 返回已有更新版本的 CLI 时，CLI 现在会在终端显示升级提示，并链接到更新说明。

2026年5月15日

APIDashboard

CloudX API — 公共 API 发布

CloudX 现在提供公共 API，可通过程序化方式访问报表、竞价检查和账号配置数据。API 使用 CloudX API key 作为 bearer token，并提供交互式 OpenAPI 参考文档。阅读文档 →

新增

报表端点 — 获取控制台摘要、拆分行、竞价方表现、应用表现、广告单元表现和 CSV 风格导出。
竞价检查端点 — 检查竞价、轮次、出价、ILRD 行以及相关投放明细。
配置端点 — 读取账号的实时、草稿和已发布配置，包括配置历史。

Dashboard — 频次控制

CloudX Dashboard 现已支持 SSP 频次控制，可同时作用于广告单元和分群。您现在可以：

按 hour、day 或 session 为单个广告单元设置频次上限
为特定分群流量设置频次上限
为未携带任何分群的请求设置默认频次上限

频次控制会在竞价前校验，并在展示成功后计数。因此，一旦受限库存达到上限，CloudX 会返回 no fill，而不会继续投放。广告单元配置方法请参见管理广告单元。

2026年5月13日

CLI

CloudX CLI 0.32

要将现有的 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 dashboard 和 cloudx report export 支持 --granularity daily|hourly；拆分报表可通过 --granularity hourly、--top、--bottom 与 --having 使用小时分桶、排序和过滤。
可配置请求超时 — 全局 cloudx --timeout <duration> 可设置 API 请求超时。默认仍为 1m，最大 2m。阅读文档 →

2026年5月7日

CLI

CloudX CLI 0.31

跨聚合平台报表来源

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

brew upgrade cloudx

新增

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

2026年5月6日

CLI

CloudX CLI 0.30

竞价列表性能与超时处理

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

brew upgrade cloudx

改进

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

2026年5月5日

CLI

CloudX CLI 0.29

竞价与配置检查

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

brew upgrade cloudx

新增

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

2026年4月28日

UnityDashboard

Unity SDK 4.0.0

新功能

新增 Unity Package Manager（UPM）消费支持，使 SDK 可在内部 UPM 包中被引用。运行时和编辑器脚本现在通过程序集定义文件（CloudX.Sdk 与 CloudX.Sdk.Editor）发布。
移除对 Newtonsoft.Json 的运行时依赖。SDK 不再要求项目中存在 com.unity.nuget.newtonsoft-json。

SDK 更新

将 Android SDK 从 3.2.0 更新至 4.0.0 — 详情请参阅 Android SDK 更新日志

Dashboard — A/B 测试

不必再凭直觉判断新订单项、竞价底价或网络配置的改动是否真正带来效果。A/B 测试让您在当前配置与编辑后的变体之间分流展示量，并实时在生产环境中并排对比关键指标——收入、eCPM、填充率与展示量。数据出炉后，一键即可上线获胜方案。打开任何启用中的广告单元，点击创建 A/B 测试，以严谨的方式优化您的变现策略。阅读文档 →

2026年4月27日

AndroidMCP

Android SDK 4.0.0

破坏性变更

适配器版本兼容性 - 适配器现在会声明其最低兼容 CloudX SDK 版本。SDK 会在初始化期间跳过不兼容的适配器。

新增

独立适配器版本 - CloudX 适配器现在独立于核心 SDK 发布，兼容的适配器更新可以按自己的发布节奏交付。

变更

发布商 Release 构建 - 改进了 release 构建兼容性，确保 SDK 初始化和适配器加载所需的 CloudX 运行时类会被保留。

修复

Release 构建初始化 - 修复了一个可能导致经过混淆压缩的发布商构建无法初始化 SDK 的问题。

CloudX MCP — AI 原生的报表与文档检索

以您习惯的方式获取所需数据。CloudX 现已上线托管的 Model Context Protocol 服务器，可直接接入 ChatGPT、Claude Code、Cursor、Codex 以及您选择的任何其他 MCP 客户端——让您的 AI 助手实时从 CloudX 获取收入、填充率、eCPM 和竞价方表现，无需在多个标签页之间反复复制粘贴。提问 “上周美国 iOS 流量表现如何？“，立即获得真实数据，筛选条件与您在控制台中完全一致。提问 “如何集成 Magnite 适配器？“，得到基于真实文档的回答。阅读文档 →

2026年4月24日

AndroidUnity

Android SDK 3.2.0

新增

Magnite 适配器 - 新增 Magnite 适配器，支持 banner、interstitial 和 rewarded 广告。
按请求覆盖竞价底价 - 新增按请求覆盖竞价底价的 API，使发布商能够通过 SDK 竞价链路传递请求级底价控制。

变更

改进了各适配器的 banner 和 MREC 生命周期处理，使渲染、刷新和清理行为更加一致。

修复

当可选适配器或广告网络 SDK 依赖在运行时缺失时，SDK 的容错能力得到提升。
修复 Vungle banner 加载错误，使无效的 banner 加载状态会通过 SDK 错误回调明确返回。

Unity SDK 3.2.0

新功能

Unity API 新增 DestroyInterstitial(adUnitId) 和 DestroyRewarded(adUnitId)，可显式销毁并清理全屏广告实例

SDK 更新

将 Android SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 iOS SDK 更新日志
新增 Android 和 iOS 的 Magnite 适配器支持

2026年4月22日

iOSCLI

iOS SDK 3.2.0

新增

Magnite 适配器 — 全新的 CloudXMagniteAdapter（横幅、中矩形、插屏、激励）。安装：pod 'CloudXMagniteAdapter', '~> 3.2.0'。
更丰富的仪表盘遥测 — 全面的遥测升级。事件采集更稳健，新增事件类型，整体可观测性显著提升。

CloudX CLI — 在终端里使用 CloudX

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

2026年4月17日

AndroidUnity

Android SDK 3.1.0

新增

原生广告 - 新增原生广告支持，包括 CloudX.createNativeAdLoader()、CloudXNativeAdLoader、CloudXNativeAd、CloudXNativeAdListener 和 CloudXNativeLoaderConfiguration，并由 Meta 适配器提供支持。

变更

改进了受支持广告网络的适配器初始化、隐私转发以及广告加载/展示可靠性。
减少启动和初始化阶段的主线程工作量，以提升应用启动稳定性并降低 ANR 风险。
Unity 2022 Meta 兼容性 - adapter-meta 现在默认传递引入 Meta Audience Network 6.20.0，以兼容 Unity 2022。如果您的集成使用原生广告，请在应用中显式添加 Meta Audience Network 6.21.0 或更高版本：
```
dependencies {
    implementation("io.cloudx:adapter-meta:3.1.0")
    implementation("com.facebook.android:audience-network-sdk:6.21.0")
}
```

修复

改进 SDK 在缺失广告网络 SDK 依赖和适配器加载失败时的容错能力。

Unity SDK 3.1.0

新功能

收益回调现在会在 Android 和 iOS 上立即触发，并且可能不在 Unity 主线程上执行

集成说明

不要在 OnAdRevenuePaid 中直接操作 Unity 场景或 UI API。如有需要，请先切回主线程。

SDK 更新

将 Android SDK 从 3.0.0 更新至 3.1.0 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.2.8 更新至 3.1.0 — 详情请参阅 iOS SDK 更新日志

2026年4月16日

iOS

iOS SDK 3.1.0

新增

Meta Reels 与原生广告 — 现已支持 Meta Reels（9:16 竖版视频）及其他 Meta 原生广告格式，通过 CLXPublisherNative 集成。本版本仅支持 Meta 原生广告；其他竞价方的支持将在未来版本中推出。
按适配器初始化超时 — SDK 初始化现在支持每个适配器的独立超时设置，启动行为更可预测。

修复

Xcode 26 兼容性 — 解决了使用 Xcode 26 编译时的构建警告。

2026年4月9日

iOS

iOS SDK 2.2.9

修复

Unity Ads 适配器 — 修复了初始化、隐私同意转发、激励回调和竞价令牌错误处理，提升了各地区的可靠性。

2026年4月6日

AndroidUnity

Android SDK 3.0.0

破坏性变更

CloudX.initialize() 现在需要 Android Context，公共广告创建 API 也需要 Context：createBanner()、createMREC()、createInterstitial() 和 createRewarded()。

变更

移除了进程启动时的自动初始化；应用现在通过 SDK 初始化和广告创建 API 显式提供 Context。
减少调用 CloudX.initialize() 之前的 SDK 工作量，降低主线程启动开销和 ANR 风险。

Unity SDK 3.0.0

SDK 更新

将 Android SDK 从 2.2.7 更新至 3.0.0 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.2.7 更新至 2.2.8 — 详情请参阅 iOS SDK 更新日志

2026年4月3日

iOS

iOS SDK 2.2.8

修复

崩溃修复 — 修复了在后台线程上并发进行广告事件追踪时可能发生的崩溃问题

2026年4月2日

AndroidUnity

Android SDK 2.2.7

修复

降低应用在调用 CloudX.initialize() 之前已引入 SDK 时的启动 ANR 风险。

Unity SDK 2.2.7

新功能

通过更新后的 Android SDK，新增一方指标遥测在更多 SDK 调用链路中的覆盖
通过更新后的 iOS SDK，修复 Banner 在延迟初始化后无法显示的问题，并提升 Vungle 适配器的运行时稳定性

集成说明

2.2.6 引入的 Unity 集成流程以及 Banner / MREC 的 placement 与 customData 调用顺序在本次发布中保持不变

SDK 更新

将 Android SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 iOS SDK 更新日志

2026年4月1日

AndroidiOSUnity

Android SDK 2.2.6

变更

改进 SDK 和广告网络适配器事件中的广告生命周期、收入和崩溃报告可靠性。
改进 banner、interstitial 和 rewarded 事件归因，使 placement 和 custom data 能够被一致跟踪。

修复

改进竞价响应解析、适配器初始化和广告加载失败路径的错误报告。

iOS SDK 2.2.7

修复

延迟横幅展示 — 修复了在 SDK 初始化完成之前创建的横幅广告在初始化成功后可能无法展示的问题
Vungle 适配器可靠性 — 修复了 Vungle 激励广告和插屏广告由于链接时方法被错误剥离而在运行时崩溃的问题

Unity SDK 2.2.6

新功能

通过更新后的 Android 和 iOS SDK，为全屏广告适配器新增 isAdReady 支持
通过更新后的 iOS SDK，新增 Unity Ads 隐私同意转发支持

集成说明

对于 Unity Banner 和 MREC 广告，如果希望首次请求就带上 placement 和 customData，请在调用 CreateBanner(...) 或 CreateMrec(...) 之前先调用 SetBannerPlacement(...) / SetBannerCustomData(...) 和 SetMrecPlacement(...) / SetMrecCustomData(...)

SDK 更新

将 Android SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 iOS SDK 更新日志

2026年3月30日

AndroidiOS

Android SDK 2.2.5

新增

新增 CloudXErrorCode.LOAD_NOT_ALLOWED_WHILE_SHOWING，用于同一个全屏广告实例正在展示时调用 load() 的场景。
新增 interstitial 和 rewarded 适配器的全屏广告就绪状态检查。

变更

改进全屏广告就绪状态处理，已过期或已失效的广告网络广告不会再被报告为可展示。
改进全屏广告复用行为，避免展示陈旧缓存广告。

修复

修复全屏广告正在展示时仍接受 load() 的问题；现在会立即通过 onAdLoadFailed(..., LOAD_NOT_ALLOWED_WHILE_SHOWING) 失败。
修复底层广告网络 SDK 已使广告对象失效或过期后，全屏广告仍被报告为可展示的问题。
修复由 CMP 管理的集成中 Mintegral GDPR 同意状态传递问题。

iOS SDK 2.2.6

新增

Unity Ads 隐私同意 — Unity Ads 适配器现在支持 GDPR 和 CCPA 隐私同意转发
isAdReady 支持 — 全屏广告适配器现在支持 isAdReady，可在调用 show 之前可靠地查询广告可用性

修复

横幅可见性准确性 — 修复了设置 banner.hidden = YES 不会暂停广告刷新的问题。隐藏的横幅可能继续加载广告而不具备展示资格，可能影响 CPM。
改进依赖兼容性 — 放宽第三方 SDK 版本约束（VungleAds、FBAudienceNetwork、InMobiSDK），防止与其他聚合 SDK 集成时出现 CocoaPods 依赖冲突
全屏广告可靠性 — 修复了广告生命周期回调在罕见情况下可能静默丢失的问题
iOS 16 崩溃修复 — 修复了 iOS 16 设备上与会话追踪相关的崩溃

2026年3月27日

Unity

Unity SDK 2.2.4

新功能

新增 SetHasUserConsent(bool?) 和 SetDoNotSell(bool?)，可在初始化前手动设置隐私覆盖值
新增 iOS 后处理逻辑：当应用尚未定义 NSUserTrackingUsageDescription 时，会自动写入该字段

修复

修复 Android Banner 视图初始化行为：新创建的 Banner 视图默认保持隐藏，直到您调用显示
修复 iOS 插屏和激励广告的展示失败回调，OnAdShowFailed 现在会同时返回失败的 CloudXAd 和对应的 CloudXError，与 Unity 回调约定保持一致
更新 Unity Demo：Banner 和 MREC 仅初始化一次，并在全屏广告加载失败或展示失败后自动重试

SDK 更新

将 Android SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 iOS SDK 更新日志

2026年3月26日

AndroidiOS

Android SDK 2.2.4

新增

服务端驱动的位置共享 - 新增服务端控制的位置共享，支持发布商选择退出，并降低坐标精度。
新增服务端控制的远程日志收集，用于协助诊断发布商集成问题。
在竞价请求中新增内容语言定向支持。
SDK 错误消息中新增更细粒度的无填充原因。

变更

改进广告生命周期事件的 SDK 诊断和崩溃报告可靠性。

修复

修复 release 构建规则，确保经过混淆压缩的应用能正确保留 CloudX 适配器。
修复 Mintegral 适配器在 Android API 23 上的崩溃问题。

iOS SDK 2.2.4

变更

服务端驱动的位置控制 — 竞价请求中的位置坐标共享现在通过 CloudX 控制面板控制（账户级别）。发布商无需更改 SDK 代码。
改进竞价请求数据 — 竞价请求现在包含内容语言，以改善广告定向

2026年3月23日

Unity

Unity SDK 2.2.3

SDK 更新

将 Android SDK 从 2.2.2 更新至 2.2.3 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.2.2 更新至 2.2.3 — 详情请参阅 iOS SDK 更新日志
新增 Android 和 iOS 的 Unity Ads 适配器支持

2026年3月20日

Android

Android SDK 2.2.3

新增

新增服务端控制的诊断日志收集，用于集成支持。

变更

将 Unity 适配器制品重命名为 adapter-unityads，并统一 SDK 设置和文档中的 Unity Ads 命名。

修复

修复 Unity Ads 网络名称大小写，使其与服务端竞价方配置匹配。

2026年3月19日

iOS

iOS SDK 2.2.3

新增

Unity Ads 适配器 — Unity Ads 适配器现已支持横幅、插屏和激励广告

修复

Unity Ads 初始化 — 修复了 Unity Ads 适配器在某些配置下可能无法正确初始化的问题

2026年3月17日

AndroidUnity

Android SDK 2.2.2

新增

通过上报适配器元数据改进 SDK 初始化诊断能力。

修复

修复 InMobi 竞价令牌获取，确保令牌收集在主线程上运行。

Unity SDK 2.2.2

SDK 更新

将 Android SDK 从 2.2.1 更新至 2.2.2 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 2.0.0 更新至 2.2.2 — 详情请参阅 iOS SDK 更新日志
将 iOS 最低部署目标从 15.0 降低至 13.0
新增 Mintegral 适配器支持（Android + iOS）

2026年3月16日

iOS

iOS SDK 2.2.2

新增

手动隐私 API — 新增 setHasUserConsent: 和 setDoNotSell: 方法，用于发布商控制的隐私同意
Mintegral 适配器 — Mintegral 适配器现已作为标准版本发布

修复

提升错误可见性 — 提高了无竞价场景的错误可见性，使填充率问题更容易诊断
全屏广告加载 — 修复了在另一个全屏广告展示时加载广告可能静默失败的问题
全屏失败回调 — 修复了全屏广告失败回调中缺少广告单元 ID 的问题
渲染器展示追踪 — 修复了 CloudX Renderer 中的可见性追踪准确性

变更

Mintegral SDK — 从 8.0.7 升级到 8.0.8

2026年3月11日

AndroidUnity

Android SDK 2.2.1

变更

加固 Mintegral 适配器，改进其在受支持广告格式中的空值和广告加载异常处理。
将 Mintegral SDK 从 17.0.61 升级到 17.0.91。

修复

修复适配器竞价扩展收集逻辑，避免某个适配器抛出异常时阻止后续适配器的扩展被包含。

Unity SDK 2.2.1

SDK 更新

将 Android SDK 从 2.2.0 更新至 2.2.1 — 详情请参阅 Android SDK 更新日志
新增 Mintegral 适配器及 Maven 仓库（Android）

2026年3月10日

AndroidUnity

Android SDK 2.2.0

新增

展示级收入数据 - 通过 AppLovin 集成新增带 CloudX 竞价关联的展示级收入跟踪。
广告点击跟踪 - 新增用户点击广告时的点击通知支持。
手动隐私 API - 新增 CloudX.setHasUserConsent() 和 CloudX.setDoNotSell()，并支持适配器隐私转发。
Kotlin 挂起初始化 - 为 Kotlin 调用方新增挂起函数 CloudX.initialize(context, config) 重载。
设备级报告 - 在可用时新增基于 Android ID 的 DAU/MAU 设备级报告。
适配器错误诊断 - 新增 banner、interstitial 和 rewarded 广告中的适配器错误报告。
广告网络 SDK 崩溃报告 - 新增对受支持广告网络 SDK 崩溃的报告能力。
素材类型支持 - CloudX 渲染器新增素材类型支持。

变更

将 CloudX 渲染器移入核心 SDK，因此发布商不再需要单独的 CloudX 渲染器适配器模块。
移除 SDK 的 appcompat 和 webkit 传递依赖，以降低依赖面和 APK 体积。
通过在临时发送失败时保留事件并重试，改进报告投递可靠性。
将 Vungle SDK 从 7.6.1 升级到 7.7.1。
将 InMobi SDK 从 11.1.0 升级到 11.1.1，其中包含上游 BroadcastReceiver 泄漏修复。

修复

修复基于地理位置的定向和报告中的位置数据处理。
修复非配置 HTTP 响应被错误报告为 INVALID_APP_KEY 的问题。
改进临时网络和服务端错误的重试分类。

Unity SDK 2.2.0

SDK 更新

将 Android SDK 从 2.0.1 更新至 2.2.0 — 详情请参阅 Android SDK 更新日志

2026年3月5日

React Native

React Native SDK 2.0.0

CloudX React Native SDK 首个稳定版本。

新增

完整的 SDK 集成：横幅、MREC、插页式和激励视频广告格式
程序化叠加 API：CloudXBannerAd 和 CloudXMRECAd
全屏广告模块：CloudXInterstitialAd 和 CloudXRewardedAd
React Hooks: useCloudXInterstitial, useCloudXRewarded, useCloudXBanner
隐私合规支持 (CCPA, GDPR, GPP)
用户定向键值对 (setUserKeyValue, setAppKeyValue)
展示级收入追踪 (addAdRevenuePaidListener)
App Tracking Transparency (iOS 14+)
展示失败事件 (addAdFailedToDisplayEventListener)
完整的 TypeScript 类型定义
Fabric (新架构) 和 Paper (旧架构) 支持

修复 (iOS — 自 2.0.0-beta.1)

修复 onInterstitialHidden / onRewardedAdHidden 关闭时重复回调
修复激励视频广告收入回调重复触发
修复 bid token 字典构建中的线程安全崩溃
showInterstitial / showRewarded 在 topViewController 为 nil 时发送展示失败事件
didFailToLoadAd: 在 adUnitId 为 nil 时广播到所有全屏监听器
rewardAmount 以 NSNumber 而非 NSString 发送
改进加载/失败路径的诊断日志

平台支持

iOS: CloudXCore ~> 2.2.0-beta
Android: io.cloudx:sdk:2.0.0

2026年3月4日

AndroidUnity

Android SDK 2.0.1

变更

通过移除 SDK 事件持久化中的数据库运行时依赖，改进 Unity 2022.3 兼容性。
将 Meta Audience Network SDK 从 6.21.0 降级到 6.20.0，以避免 Unity 2022.3 构建兼容性问题。

修复

修复展示跟踪期间可能出现的并发问题。
修复使用 singleTask 启动模式的应用中的 Meta rewarded 广告处理。

Unity SDK 2.0.1

此补丁版本增加了对 Unity Engine 2022.3 的完整兼容性。

兼容性

新增对 Unity Engine 2022.3 LTS 的支持

SDK 更新

将 Android SDK 从 2.0.0 更新至 2.0.1 — 详情请参阅 Android SDK 更新日志

2026年2月26日

React Native

React Native SDK 2.0.0-beta.1

新增

完整的 CloudX Core SDK 集成
通过 CloudXBannerAd 模块支持横幅广告
通过 CloudXMRECAd 模块支持 MREC 广告 (300x250)
通过 CloudXInterstitialAd 模块支持插页式广告
通过 CloudXRewardedAd 模块支持激励视频广告
React Hooks: useCloudXInterstitial, useCloudXRewarded, useCloudXBanner
隐私合规支持 (CCPA, GDPR, GPP)
用户定向键值对
展示级收入追踪
App Tracking Transparency (iOS)
完整的 TypeScript 类型定义
Fabric (新架构) 和 Paper (旧架构) 支持

平台支持

iOS: CloudXCore ~> 2.1.0-beta
Android: io.cloudx:sdk:2.0.0

2026年2月5日

Unity

Unity SDK 2.0.0

重大变更

横幅广告和 MREC 广告在创建后不再自动加载。现在必须在 CreateBanner() 或 CreateMrec() 之后显式调用 LoadBanner() 或 LoadMrec()
CloudXAd 属性重命名：
- PlacementName 更名为 AdUnitId
- BidderName 更名为 NetworkName

新功能

为所有广告格式添加了广告位和自定义数据支持：
- SetBannerPlacement(adUnitId, placement) 和 SetBannerCustomData(adUnitId, customData)
- SetMRecPlacement(adUnitId, placement) 和 SetMRecCustomData(adUnitId, customData)
- ShowInterstitial(adUnitId, placement?, customData?) 现在接受可选的广告位和自定义数据参数
- ShowRewarded(adUnitId, placement?, customData?) 现在接受可选的广告位和自定义数据参数
新增 CloudXAd 属性：AdFormat、Placement、NetworkPlacement

SDK 更新

将 Android SDK 从 0.12.1 更新至 2.0.0
将 Android 适配器从 0.12.1 更新至 2.0.0
将 iOS CloudXCore 从 1.3.0 更新至 2.0.0
将 iOS CloudXRenderer 从 1.3.0 更新至 2.0.0
将 iOS 适配器从 1.3.0 更新至 2.0.0

2026年2月4日

AndroidiOS

Android SDK 2.0.0

此版本将 placement name 替换为 CloudX 控制台中的 广告单元 ID。请将 createBanner()、createMREC()、createInterstitial() 和 createRewarded() 调用从 placement name 更新为广告单元 ID。

新增

Rewarded 广告 - 新增 rewarded 广告支持，包括 CloudX.createRewarded()、CloudXRewardedAd、CloudXRewardedListener 和 CloudXReward。
InMobi 适配器 - 新增 InMobi 适配器，支持 banner、MREC、interstitial 和 rewarded 广告。
Vungle Rewarded 广告 - 为 Vungle 适配器新增 rewarded 广告支持。
新增 CloudX.isInitialized()，用于检查 SDK 初始化状态。
新增 CloudX.getVersion()，用于获取 SDK 版本字符串。
在 CloudXAdView 上新增 setPlacement() 和 setCustomData()，用于跟踪。
在全屏广告上新增 show(activity, placement, customData) 重载，用于跟踪。
在 onInitialized() 回调中新增 CloudXSdkConfiguration。
新增 CloudXAd.networkPlacement，用于读取广告网络特定的 placement ID。
新增错误码：NETWORK_NO_CONNECTION、AD_ALREADY_SHOWING、DONT_KEEP_ACTIVITIES_ENABLED、AD_NOT_READY 和 INVALID_APP_KEY。

破坏性变更

将 minSdk 从 21 提升到 23。
将 CloudXInitializationParams 替换为 CloudXInitializationConfiguration。
将 createBanner()、createMREC()、createInterstitial() 和 createRewarded() 中的 placementName 参数重命名为 adUnitId。
将 CloudXAd.placementId 重命名为 adUnitId。
移除 CloudXAd.placementName。
将 CloudXAd.bidderName 重命名为 networkName。
将 CloudXErrorCode.INVALID_PLACEMENT 重命名为 INVALID_AD_UNIT。
将 onAdLoadFailed(placementName, cloudXError) 改为 onAdLoadFailed(adUnitId, cloudXError)。
将 onAdDisplayFailed(cloudXError) 改为 onAdDisplayFailed(cloudXAd, cloudXError)。
将 onInitialized() 改为 onInitialized(configuration: CloudXSdkConfiguration)。
移除 testMode 初始化参数；test mode 现在由服务端控制。
将 interstitial 和 rewarded 广告的 show() 改为 show(activity)。

变更

将 Meta Audience Network SDK 从 6.17.0 升级到 6.21.0。

修复

修复 onAdHidden 和 onAdDisplayFailed 回调中的广告重新加载行为。
确保所有 load() 和 show() 回调都会在 UI 线程上投递。

iOS SDK 2.0.0

此版本将 placement 名称替换为 CloudX 仪表板中的 Ad Unit ID。请更新您的 createBannerWithAdUnitId:、createMRECWithAdUnitId:、createInterstitialWithAdUnitId: 和 createRewardedWithAdUnitId: 调用，使用 ad unit ID 而非 placement 名称。

新增

激励广告，使用 createRewardedWithAdUnitId:delegate: 和 CLXRewardedDelegate
InMobi 适配器（SDK 11.1），支持横幅、MREC、插屏和激励广告
CLXAd.networkPlacement 属性用于获取网络特定的 placement ID

重大变更

在 createBannerWithAdUnitId:、createMRECWithAdUnitId:、createInterstitialWithAdUnitId:、createRewardedWithAdUnitId: 中将 placement 参数重命名为 adUnitId
将 CLXAd.placement 重命名为 adUnitId
将 CLXAd.bidderName 重命名为 networkName
将 CLXErrorCodeInvalidPlacement 重命名为 CLXErrorCodeInvalidAdUnit
更改 bannerAdView:didFailWithError: 以在错误中包含 ad unit ID
从 initializeSDKWithAppKey:completion: 中移除 testMode 参数 - 测试模式现在通过仪表板进行服务端控制

变更

Meta Audience Network SDK 从 6.17.0 更新到 6.21.0
Vungle SDK 从 7.4.2 更新到 7.6.0

修复

修复 IFA（广告标识符）收集问题
修复国家/地理定向数据收集问题

2026年1月15日

Unity

Unity SDK 0.12.1

新功能

新增对 iOS 平台的支持

性能改进

Android：BidToken 现在在后台线程生成，提升了性能

SDK 更新

将 Android SDK 从 0.12.0 更新至 0.12.1

改进

重命名内部 UnityMainThreadDispatcher 类，避免与第三方包命名空间冲突

2025年12月23日

Android

Android SDK 0.12.1

修复

修复 Meta 适配器在主线程收集竞价令牌导致的 ANR 风险。

Android SDK 0.11.1

修复

修复 Meta 适配器在主线程收集竞价令牌导致的 ANR 风险。

2025年12月15日

Unity

Unity SDK 0.12.0

CloudX Unity SDK 初始发布

2025年12月14日

AndroidiOS

Android SDK 0.12.0

破坏性变更

移除 CloudXError.effectiveMessage；请直接使用 message。
移除 setLoggingEnabled()；请使用 setMinLogLevel(CloudXLogLevel.NONE) 禁用日志。
移除 CloudXPrivacy；隐私现在通过标准隐私信号自动处理。

变更

通过 GPP Section 2 解析和供应商同意检查增强 GDPR 支持。
简化 TCF purpose 检查，现在只需要 purpose 1 和 2。
新增通过 GPP 支持 CCPA，并保留旧版 US Privacy 回退。
移除 COPPA 处理。
新增 CloudXLogLevel.NONE，用于禁用日志。

修复

修复初始化期间的 geo API 失败处理。

iOS SDK 1.3.0

新增

横幅刷新重试 - 横幅广告现在在隐藏后会自动重试加载失败的广告

修复

App Extension 兼容性 - SDK 现在可以在 App Extensions 中正常工作（无 UIApplication 调用）
激励广告代理回调 - 修复回调顺序错误
符号冲突 - 所有分类方法现在都以 clx_ 为前缀以防止冲突

变更

CloudXCore 现在以动态框架分发 - 支持 SDK 问题的崩溃符号化

2025年12月9日

Android

Android SDK 0.11.0

变更

将 SDK HTTP 客户端从 Ktor 3.0.3 迁移到 OkHttp 4.12.0。
为所有广告格式新增已销毁状态保护。

2025年12月4日

iOS

iOS SDK 1.2.1

新增

可视化调试器按钮 - 用于开发和 QA 的新调试工具
高 ROI 键值定向示例 - 增强的演示应用，包含定向信号示例

修复

更正 podspecs 中的 vendored_frameworks 路径

2025年12月3日

Android

Android SDK 0.10.0

新增

Vungle 适配器 - 新增 Vungle 适配器，支持 banner 和 interstitial 广告。

变更

将日志标签简化为 CloudX，便于 logcat 过滤。
为公共 API 入口新增日志，便于集成调试。
当找不到适配器时，SDK 初始化现在会尽早失败并返回清晰错误。

修复

修复 banner 加载失败后刷新停止的问题。

2025年11月26日

AndroidiOS

Android SDK 0.9.0

新增

通过 CloudXAdRevenueListener.onAdRevenuePaid() 新增广告收入跟踪。

变更

将 Ktor 从 2.3.8 升级到 3.0.3，提升与使用 Ktor 3.x 的应用的兼容性。

修复

修复广告生命周期管理中的内存泄漏。
改进 SDK 稳定性。

iOS SDK 1.2.0

🚀 首次正式发布

CloudX iOS SDK 的初始版本，支持横幅、MREC 和插屏广告。

2025年11月3日

Android

Android SDK 0.6.0

新增

为 CloudXInitializationParams 新增 testMode 支持，用于开发期间请求测试广告。

2025年10月27日

Android

Android SDK 0.4.0

新增

CloudX Android SDK 初始 alpha 版本。
新增 banner 和 MREC 广告支持。
新增 interstitial 广告支持。
新增通过 CloudX mediation 的实时竞价。
新增 CloudX 和 Meta Audience Network 适配器支持。
新增 GDPR、CCPA、US Privacy、TCF 和 GPP 信号的隐私合规支持。
新增用于竞价优化的会话深度跟踪。
新增广告生命周期回调和错误处理。
新增可配置日志级别的调试日志。

Documentation Index

​Android SDK 4.1.2

​新增

​变更

​iOS SDK 3.4.1

​新增

​修复

​Unity SDK 4.1.0

​新功能

​SDK 更新

​Android SDK 4.1.1

​新增

​变更

​React Native SDK 3.4.0

​新增

​变更

​平台支持

​Android SDK 4.1.0

​新增

​iOS SDK 3.4.0

​新增

​变更

​修复

​CloudX CLI 0.33

​配置验证、订单项编辑与发布

​新增

​CloudX API — 公共 API 发布

​新增

​Dashboard — 频次控制

​CloudX CLI 0.32

​新增

​CloudX CLI 0.31

​跨聚合平台报表来源

​新增

​CloudX CLI 0.30

​竞价列表性能与超时处理

​改进

​CloudX CLI 0.29

​竞价与配置检查

​新增

​Unity SDK 4.0.0

​新功能

​SDK 更新

​Dashboard — A/B 测试

​Android SDK 4.0.0

​破坏性变更

​新增

​变更

​修复

​CloudX MCP — AI 原生的报表与文档检索

​Android SDK 3.2.0

​新增

​变更

​修复

​Unity SDK 3.2.0

​新功能

​SDK 更新

​iOS SDK 3.2.0

​新增

​CloudX CLI — 在终端里使用 CloudX

​Android SDK 3.1.0

​新增

​变更

​修复

​Unity SDK 3.1.0

​新功能

​集成说明

​SDK 更新

​iOS SDK 3.1.0

​新增

​修复

​iOS SDK 2.2.9

​修复

​Android SDK 3.0.0

​破坏性变更

​变更

​Unity SDK 3.0.0

​SDK 更新

​iOS SDK 2.2.8

​修复

Android SDK 4.1.2

新增

变更

iOS SDK 3.4.1

新增

修复

Unity SDK 4.1.0

新功能

SDK 更新

Android SDK 4.1.1

新增

变更

React Native SDK 3.4.0

新增

变更

平台支持

Android SDK 4.1.0

新增

iOS SDK 3.4.0

新增

变更

修复

CloudX CLI 0.33

配置验证、订单项编辑与发布

新增

CloudX API — 公共 API 发布

新增

Dashboard — 频次控制

CloudX CLI 0.32

新增

CloudX CLI 0.31

跨聚合平台报表来源

新增

CloudX CLI 0.30

竞价列表性能与超时处理

改进

CloudX CLI 0.29

竞价与配置检查

新增

Unity SDK 4.0.0

新功能

SDK 更新

Dashboard — A/B 测试

Android SDK 4.0.0

破坏性变更

新增

变更

修复

CloudX MCP — AI 原生的报表与文档检索

Android SDK 3.2.0

新增

变更

修复

Unity SDK 3.2.0

新功能

SDK 更新

iOS SDK 3.2.0

新增

CloudX CLI — 在终端里使用 CloudX

Android SDK 3.1.0

新增

变更

修复

Unity SDK 3.1.0

新功能

集成说明

SDK 更新

iOS SDK 3.1.0

新增

修复

iOS SDK 2.2.9

修复

Android SDK 3.0.0

破坏性变更

变更

Unity SDK 3.0.0

SDK 更新

iOS SDK 2.2.8

修复

Android SDK 2.2.7