更新日志

​

[3.4.6] - 2026-06-20

使 React Native 包装层与 CloudX 原生 Android 4.1.5 对齐；iOS 保持 3.4.5。本次发布没有 JavaScript API 变更。

​

新增

• (Android) MobileFuse 适配器可用 - 现可通过 io.cloudx:adapter-mobilefuse:1.11.0.0 在 Android React Native 应用中接入 MobileFuse 需求（横幅、MREC、插页式、激励视频）。
• (Android) Pangle 适配器就绪 - 现可通过 io.cloudx:adapter-pangle:8.1.0.3.0 在 Android 上接入 Pangle 需求。

​

变更

• 将底层 Android 原生依赖更新为 io.cloudx:sdk:4.1.5（iOS CloudXCore ~> 3.4.5 保持不变）。
• (Android) 启动更快 - 减少了因设备信号采集导致的初始化与广告请求停顿。
• (Android) 全屏 HTML 渲染 - SDK 现可在插页式和激励视频广告位渲染 CloudX 投放的全屏 HTML 素材，并支持可见性测量。由服务端控制发布；无需应用改动。
• (Android) 更广泛的原生广告入横幅覆盖 - Vungle 原生需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位（与 Meta、Moloco 一起），需在对应订单项中启用。

​

修复

• (Android) 全屏可靠性 - 全屏 HTML 广告的关闭行为与隐藏回调更可靠，激励视频被提前关闭时的奖励处理更安全。
• (Android) 原生广告图片处理 - 原生素材的图片加载更可靠，防止复用广告视图时出现过时图片。

​

平台支持

• iOS：CloudXCore ~> 3.4.5
• Android：io.cloudx:sdk:4.1.5

---

​

[3.4.5] - 2026-06-16

使 React Native 包装层与 CloudX 原生 iOS 3.4.5 对齐；Android 保持 4.1.3。本次发布没有 JavaScript API 变更。

​

修复

• (iOS) 插页式和激励视频广告现可在旧架构 (Paper) 上正常显示 - 在使用旧版 React Native 架构构建的应用中，全屏广告可能加载成功但无法显示。现已可正常展示。新架构 (Fabric) 应用不受影响。
• (iOS) 部分有效的 HTML 横幅和 MREC 素材不再被跳过 - 之前被误判为损坏的素材现可正常渲染。
• (iOS) Meta 和 Moloco 原生广告可靠性 - 原生广告入横幅及入 MREC 素材的资源校验与注册更可靠，展示与点击跟踪更稳定。
• (iOS) Digital Turbine 启动冲突 - 当另一个聚合 SDK 先初始化共享的 Fyber SDK 时，CloudX 适配器现会延后处理而非重新初始化。为获得最顺畅的启动流程，请先初始化另一个聚合 SDK，再初始化 CloudX。

​

变更

• 将底层 iOS 原生依赖更新为 CloudXCore ~> 3.4.5（Android io.cloudx:sdk:4.1.3 保持不变）。请将 iOS 的 CloudX* 适配器 pod 同步更新为 ~> 3.4.5。
• (iOS) 更广泛的原生广告入横幅覆盖 - InMobi 和 Vungle 的原生需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位（与 Meta、Moloco 一起），需在对应订单项中启用。
• (iOS) HTML 插页式渲染 - CloudX 渲染器现支持全屏 HTML 插页式素材。由服务端控制发布；无需应用改动。
• (iOS) 慢速广告网络不再拖慢启动 - 若某网络 SDK 初始化较慢，CloudX 初始化将不等待它直接完成，该网络在初始化完成后自动加入后续竞价。

​

平台支持

• iOS：CloudXCore ~> 3.4.5
• Android：io.cloudx:sdk:4.1.3

---

​

[3.4.4] - 2026-06-12

使 React Native 包装层与 CloudX 原生 SDK 对齐 — iOS 3.4.4 和 Android 4.1.3。本次发布没有 JavaScript API 变更；应用通过现有 React Native API 即可获得原生平台改进和更丰富的适配器阵容。

​

新增

• Digital Turbine 适配器支持 - 双平台均可在 React Native 应用中接入 Digital Turbine 广告需求（横幅、MREC、插页式、激励视频）。iOS：pod 'CloudXDigitalTurbineAdapter', '~> 3.4.4'；Android：io.cloudx:adapter-digitalturbine:8.4.5.0。
• (iOS) Pangle 适配器 - pod 'CloudXPangleAdapter', '~> 3.4.4'（横幅/MREC、插页式、激励视频）。
• (iOS) Google Waterfall 适配器 - pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.4'（横幅、MREC）；需要在应用的 Info.plist 中配置 Google 广告应用标识符。
• (Android) 原生广告入横幅渲染 - 来自受支持网络（Meta、Moloco、Vungle）的原生广告需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位。

​

变更

• 底层原生 SDK 版本更新为 iOS CloudXCore ~> 3.4.4 和 Android io.cloudx:sdk:4.1.3。
• (Android) 更具韧性的适配器初始化 - 缓慢的广告网络不再拖慢 SDK 启动；未就绪的适配器会暂不参与竞价，就绪后自动加入。
• (Android) 服务端控制的始终发放奖励模式 - 可在控制台按 line item 配置保证触发奖励回调，无需应用侧改动。

​

修复

• (iOS) App Store 提交被拒 - 移除了 SDK 二进制中可能导致 App Store 审核被拒的受限 URL scheme。
• (iOS) 部分账户 SDK 初始化失败 - 没有组织标识符的账户现在也能正常完成初始化。
• (iOS) Google Waterfall 丢单 - 响应较慢但最终成功的瀑布流响应不再被丢弃，提升填充可靠性。
• (iOS) Digital Turbine 兼容性 - 横幅、MREC、插页式和激励视频现已兼容 Fyber 8.x 全系列版本。

​

平台支持

• iOS: CloudXCore ~> 3.4.4
• Android: io.cloudx:sdk:4.1.3

---

​

[3.4.0] - 2026-05-25

​

新增

• 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

---

​

[2.0.0] - 2026-03-05

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

---

​

[2.0.0-beta.1] - 2026-02-26

​

新增

• 完整的 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