更新日志

React Native SDK 版本历史

[3.7.0] - 2026-08-11

CloudX React Native 3.7.0 使包装层与 CloudX iOS 3.7.0 和 Android 4.5.0 对齐。本次发布新增 Google 需求的 Trusted Arbiter 支持、Google Ad Manager 收入上报，并更新原生设置版本和连接器指南。

新增

Trusted Arbiter Google 出价 - 可使用 CloudXArbiterBid.adMob() 和 CloudXArbiterBid.gam() 将 CloudX 与已加载的 AdMob 或 Google Ad Manager 广告进行比较。
Google Ad Manager 收入上报 - 可将 CloudXRevenuePlatform.GAM 与 CloudX.reportRevenueData() 配合使用，让 GAM paid event 进入报表和 Trusted Arbiter 定价。
(iOS) TaurusX 适配器 - 新增 pod 'CloudXTaurusXAdapter', '~> 1.18.1.0'，支持 Banner、MREC、插屏和激励需求。
可选 MMP 连接器设置 - React Native 宿主应用可在 iOS 和 Android 添加 Adjust 与 AppsFlyer 原生广告收入连接器，无需 JavaScript 胶水代码。
(Android) Banner 与 MREC 原生测试广告 - CloudX 测试广告现在可在 Banner 和 MREC 广告位中渲染原生素材。

变更

底层原生 SDK 版本更新为 iOS CloudXCore ~> 3.7.0 和 Android io.cloudx:sdk:4.5.0。
Google 适配器 - 设置更新为 iOS CloudXGoogleWaterfallAdapter ~> 13.6.0.2、Android io.cloudx:adapter-googlewaterfall:25.2.0.2 和 Android GMA Next-Gen io.cloudx:adapter-admob:1.3.0.1。
(Android) Meta 适配器 - 设置更新为 io.cloudx:adapter-meta:6.22.0.0。使用此适配器的应用必须以 Android API 36 编译。
(Android) Mintegral 适配器 - 设置更新为 io.cloudx:adapter-mintegral:17.1.71.1。
(Android) React Native 0.82+ 支持 - 使用 React Native 0.82+ 的 Android 宿主应用现在会自动使用所需的新架构路径构建。

修复

(iOS) Banner 与 MREC 资源清理 - 自动刷新的内嵌广告视图以及未调用 destroy() 就释放的广告现在会正确清理。
(Android) 全屏广告回调可靠性 - 插屏和激励广告展示时不再重放过期错误；广告销毁后的延迟广告网络回调也会被安全处理。

平台支持

iOS：CloudXCore ~> 3.7.0
Android：io.cloudx:sdk:4.5.0

[3.6.1] - 2026-08-03

CloudX React Native 3.6.1 新增 Trusted Arbiter 自定义出价输入，改进 Android 无胜出结果处理，并更新 iOS Pangle 适配器版本。现有广告格式集成无需迁移。

新增

Trusted Arbiter 自定义出价 - 可使用 CloudXArbiterBid.custom() 将 CloudX 与发布商传入的聚合平台或广告网络出价进行比较。

变更

(iOS) Pangle 适配器 - iOS 设置更新为 pod 'CloudXPangleAdapter', '~> 8.2.0.7.0'。

修复

(Android) Trusted Arbiter 无胜出结果 - 当没有有效自定义出价胜出时，Android 现在会返回 NONE。

平台支持

iOS：CloudXCore ~> 3.6.0
Android：io.cloudx:sdk:4.4.0

[3.6.0] - 2026-07-29

CloudX React Native 3.6.0 使包装层与 CloudX iOS 3.6.0 和 Android 4.4.0 对齐。本次发布新增 App Open 和发布商上报收入 API，更新原生依赖版本，并保持现有横幅、MREC、插页式和激励视频集成无需迁移。

新增

App Open 广告 - 新增 CloudXAppOpenAd 和 useCloudXAppOpen，用于应用启动和回到前台时展示的全屏广告位，由 CloudX iOS 和 Android 的原生 App Open 支持提供能力。
发布商上报收入 API - 新增 CloudX.reportRevenueData() 和 CloudXRevenueData，应用可将聚合平台的 paid event 转发到 CloudX 报表。收入请以 JavaScript number 传入货币单位，而不是 micros。
扩展原生适配器设置 - React Native 应用可使用本次发布对应的原生适配器集合，包括 iOS 独立版本适配器 pin 和 Android TaurusX 适配器。

变更

底层原生 SDK 版本更新为 iOS CloudXCore ~> 3.6.0 和 Android io.cloudx:sdk:4.4.0。
(iOS) 从设置中移除 CloudXRenderer - React Native Podfile 中不要再添加 CloudXRenderer。从 iOS 3.5.0 开始，渲染器功能已内置于 CloudXCore。
(iOS) 独立适配器版本 - iOS 设置现在使用独立的适配器版本和 CloudXMagniteAdapterV2，与 iOS 3.5+ 原生打包模型保持一致。
(Android) 更安全的加载和预取行为 - 包含 Android 4.3.0 对重复 load() 调用和过期 Google Waterfall 预取填充的改进。

修复

(iOS) CloudX 投放素材渲染 - 包含 iOS 3.6.0 对空白横幅/MREC 素材以及 HTML 激励素材被拒绝的问题修复。
(Android) 运行时兼容性 - 包含 Android 4.4.0 对电话权限检查以及在 SDK 最低 Android 版本上 VAST tracker 兼容性的修复。
(Android) 原生广告展示收入 - 包含 Android 4.3.0 对同步原生广告展示收入回调可靠性的修复。

平台支持

iOS：CloudXCore ~> 3.6.0
Android：io.cloudx:sdk:4.4.0

[3.4.7] - 2026-07-28

新增 React Native 布局内横幅和 MREC 组件 API，同时保留现有程序化叠加 API。

新增

组件横幅和 MREC 视图 - 发布商现在可以在 React Native 布局中直接渲染 CloudXBannerView 和 CloudXMRECView，广告会参与普通视图定位、安全区域处理和覆盖层层级顺序。
声明式组件元数据 - 组件横幅和 MREC 支持 placement、customData 和 extraParameters props，用于报表统计以及广告网络或服务端配置。
组件回调 - 组件视图支持 onAdLoaded、onAdLoadFailed、onAdClicked 和 onAdRevenuePaid 回调 props。

变更

将底层 Android 原生依赖更新为 io.cloudx:sdk:4.1.7（iOS CloudXCore ~> 3.4.5 保持不变）。
对于需要固定原生叠加定位的应用，现有 CloudXBannerAd 和 CloudXMRECAd 程序化叠加 API 仍可继续使用。

平台支持

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

[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 — 并为横幅、MREC、插屏和激励视频广告新增每次加载的额外参数。

新增

每次加载的额外参数 - CloudXBannerAd、CloudXMRECAd、CloudXInterstitialAd 和 CloudXRewardedAd 现已提供 setExtraParameters(adUnitId, parameters)。广告加载时会记录参数值；参数值支持 string、number、boolean、null、数组和嵌套对象。
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

[3.2.0] - 2026-05-12

本次发布将 React Native SDK 使用的 CloudX iOS 和 Android 原生 SDK 更新至 3.2.0。从 3.1.2 升级的发布商无需修改 JavaScript API 调用。

新增

Magnite 适配器支持 — 在 iOS 和 Android 上新增 Magnite 适配器包支持。
改进诊断能力 — 扩展原生事件可见性，便于控制台和运营问题排查。
(Android) 底价控制 — 在广告请求流程中新增原生底价控制支持。

变更

将底层 iOS 和 Android 原生 SDK 从 3.1.0 更新至 3.2.0。
(Android) 横幅生命周期处理 — 改进横幅视图的挂载和分离行为，使适配器表现更加一致。

修复

(Android) 适配器发现诊断 — 缺少适配器依赖时提供更清晰的诊断信息。
(Android) 横幅加载错误 — 当广告网络报告横幅已加载但未提供可渲染视图时，返回更明确的加载失败诊断。

平台支持

iOS: CloudXCore ~> 3.2.0
Android: io.cloudx:sdk:3.2.0

[3.1.2] - 2026-04-21

本次主要版本升级使 React Native SDK 与 3.1.0 原生 SDK 对齐，并新增 JavaScript 手动隐私 API。

新增

手动隐私 API — CloudX.setHasUserConsent(value) 和 CloudX.setDoNotSell(value) 可在 iOS 和 Android 上调用原生隐私 API。传入 boolean 可设置值，传入 null 可清除手动设置并回退到 IAB 存储。
错误码 — CloudXErrorCode 新增 LOAD_NOT_ALLOWED_WHILE_SHOWING (303) 和 ADAPTER_INITIALIZATION_TIMEOUT (622)。

变更

底层原生 SDK 从 2.2.3 更新至 3.1.0。平台特定详情请参阅原生更新日志：

本 SDK 现固定使用 iOS CloudXCore ~> 3.1.0 和 Android io.cloudx:sdk:3.1.0，所有捆绑适配器也固定至同一主版本。原生 Android SDK 新增的 Context 要求已由桥接层处理，发布商无需修改代码。

修复

(iOS) Release 构建编译错误 — 修复早期 3.1.0 和 3.1.1 版本导致应用无法归档并提交 App Store 的编译错误。
横幅和 MREC 渲染延迟 — 在部分设备上，横幅或 MREC 可能报告加载成功，但要等到下一次自动刷新（约 30 秒）才显示。现在首次调用 show 时会立即渲染。

从 2.2.3 升级

(iOS) 移除手动顶部安全区补偿。 如果你使用 CloudXBannerAd.createAdWithOffsets 并把设备顶部安全区高度作为 yOffset（例如 react-native-safe-area-context 的 insets.top），请移除该补偿；额外偏移现在会使横幅偏离到安全区下方。
(iOS) TOP_CENTER 和 BOTTOM_CENTER 横幅现在会自动位于安全区内。 默认放置请使用 CloudXBannerAd.createAd(adUnitId, CloudXAdPosition.TOP_CENTER)。
横幅和 MREC 视图生命周期。 横幅和 MREC 现在会在脱离视图层级的状态下加载，并在调用 showBanner / showMREC 时挂载到 iOS 展示视图控制器或 Android 根内容视图。此项仅面向在 create 和 show 之间检查原生视图层级的发布商。
将横幅和 MREC 预加载到内存。 由于广告在脱离状态下加载，你现在可以预加载横幅或 MREC 并稍后展示，而不会提前占用父视图。