更新日志

CloudX 综合发布说明

2026年9月16日

Unity

Unity SDK 4.7.2

SDK 更新

Android 和 iOS Magnite 适配器版本从 1.0.0.1 更新至 1.0.0.2。
Android Unity Ads 适配器版本从 4.19.0.1 更新至 4.20.1.0。
iOS Unity Ads 适配器版本从 4.19.0.0 更新至 4.20.1.0。
iOS Google Waterfall 适配器版本从 13.7.0.0 更新至 13.9.0.0。
Android SDK 版本仍为 4.7.0。iOS CloudXCore 版本仍为 3.9.1。

此版本未更改 Unity C# API。Unity SDK 尚未提供 Native 广告 API。

2026年9月15日

Android
iOS
Unity
CLI
API

Android SDK — AppLovin Auction 适配器 13.6.3.0

新增

首个公开 AppLovin Auction 适配器版本 - 使用 AppLovin SDK 13.6.3，支持开屏、插屏、激励和原生广告。要求 CloudX SDK 4.7.0 或更高版本。安装：implementation("io.cloudx:adapter-applovin:13.6.3.0")。

iOS SDK — AppLovin Auction 适配器 13.6.3.0

新增

首个公开 AppLovin Auction 适配器版本 — 使用 AppLovinSDK 13.6.3，支持开屏、插屏、激励和原生广告。要求 CloudXCore >= 3.9.0。安装：pod 'CloudXAppLovinAdapter', '~> 13.6.3.0'。

iOS SDK — Unity Ads 适配器 4.20.1.0

变更

已通过 UnityAds 4.20.1 认证 — CloudXCore >= 3.5.0 与 iOS 13.0 要求保持不变。安装：pod 'CloudXUnityAdsAdapter', '~> 4.20.1.0'。

iOS SDK — Unity Ads 适配器 4.20.0.0

变更

已通过 UnityAds 4.20.0 认证 — CloudXCore >= 3.5.0 与 iOS 13.0 要求保持不变。安装：pod 'CloudXUnityAdsAdapter', '~> 4.20.0.0'。

Unity SDK 4.7.1

修复

iOS 激励广告及其他全屏广告的回调现在使用每次已接受展示请求对应的 placement 和 custom data。连续展示激励广告时，不再出现 custom data 缺失或沿用旧值的问题。

SDK 更新

将 iOS SDK 从 3.9.0 更新至 3.9.1 — 详情请参阅 iOS SDK 更新日志。
Android SDK 保持为 4.7.0。
更新 Android 适配器：Moloco 从 4.11.0.0 更新至 4.12.0.0，Google Waterfall 从 25.2.0.5 更新至 25.4.0.0，Pangle 从 8.2.0.4.0 更新至 8.3.0.3.0。
更新 iOS 适配器：Moloco 从 4.8.0.0 更新至 4.10.0.0，Google Waterfall 从 13.6.0.4 更新至 13.7.0.0，Digital Turbine 从 8.4.8.0 更新至 8.4.10.0，Pangle 从 8.2.0.7.0 更新至 8.3.0.6.0。

CloudX CLI 0.39

需求对比报表

CloudX CLI 0.39 为具有功能访问权限和 reports:read 权限的账号新增需求对比汇总与广告单元报表。

新增

需求方来源汇总。 使用 cloudx report demand-comparison 对比 CloudX 与需求方的收入、eCPM 和展示数。报表还会显示映射覆盖情况和需求方报表时效信息。
广告单元对比。 使用 cloudx report demand-comparison-ad-units --demand-source DEMAND_SOURCE 查看已映射的需求方聚合结果。添加 --view unmapped 可查看被排除的需求方收入和展示数。
已结束的报表时间范围。 省略 --period 时，命令选择最近 30 个已结束的日历日期。显式时间段最多包含 31 个日期，并支持 IANA 时区。
灵活的过滤器。 可重复使用需求方来源和标识符标志，也可传入逗号分隔的多个值。使用 --json 可返回完整的 API 响应。阅读文档 →

CloudX API — 需求对比报表

公共 API 现已为具有功能访问权限和 reports:read 权限的账号提供需求对比汇总与广告单元报表。

GET /report/demand-comparison 对比 CloudX 与需求方的收入、eCPM 和展示数，并返回已匹配的 CloudX 广告单元、映射缺口和需求方报表时效信息。
GET /report/demand-comparison/ad-units 默认返回已映射的需求方聚合结果。设置 view=unmapped 可返回因映射缺失或不明确而被排除的需求方行，以及 excluded_partner_revenue 和 excluded_partner_impressions。
需求方来源过滤器使用重复查询参数。需求方业务、需求方资产和 CloudX 广告单元过滤器接受逗号分隔的多个值。
报表时间范围最多包含 31 个已结束的日历日期。最近的已结束日期在 UTC 12:00 发生变化。

阅读 CLI 报表指南 →

2026年9月14日

iOS SDK — Google Waterfall 适配器 13.9.0.0

变更

已通过 Google Mobile Ads SDK 13.9.0 认证 — CloudXCore >= 3.7.0 与 iOS 13.0 要求保持不变。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.9.0.0'。

iOS SDK — Google Waterfall 适配器 13.8.0.0

变更

已通过 Google Mobile Ads SDK 13.8.0 认证 — CloudXCore >= 3.7.0 与 iOS 13.0 要求保持不变。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.8.0.0'。

iOS SDK — Google Waterfall 适配器 13.7.0.0

变更

已通过 Google Mobile Ads SDK 13.7.0 认证 — CloudXCore >= 3.7.0 与 iOS 13.0 要求保持不变。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.7.0.0'。

修复

手动集成的适配器现在会检查并要求已有的 CloudXCore 3.7.0 最低版本。

iOS SDK 3.9.1

安装：pod 'CloudXCore', '~> 3.9'

变更

全局广告收入委托和 MMP 连接器不再接收来自聚合平台的重复收入 — 当服务器将竞价方标记为由其 SDK 上报时，不再重复转发该收入。单个广告的收入委托和 CloudX 展示事件不受影响。

修复

激励视频广告和其他全屏广告的回调现在使用本次已接受展示的广告位和自定义数据。 连续展示激励视频广告时，不再复用缺失或过期的归因数据。

iOS SDK — Digital Turbine 适配器 8.4.10.0

变更

已通过 Fyber Marketplace SDK 8.4.10 认证 — 要求 iOS 15.0+ 和 Xcode 26.1+；CloudXCore >= 3.5.0 保持不变。改进了点击处理。安装：pod 'CloudXDigitalTurbineAdapter', '~> 8.4.10.0'。

iOS SDK — Moloco 适配器 4.10.0.0

变更

已通过 MolocoSDKiOS 4.10.0 认证 — 将内置的 MolocoSDKiOS 从 4.9.1 更新至 4.10.0。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXMolocoAdapter', '~> 4.10.0.0'。

iOS SDK — Moloco 适配器 4.9.1.0

变更

已通过 MolocoSDKiOS 4.9.1 认证 — 将内置的 MolocoSDKiOS 从 4.9.0 更新至 4.9.1。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXMolocoAdapter', '~> 4.9.1.0'。

iOS SDK — Moloco 适配器 4.9.0.0

变更

已通过 MolocoSDKiOS 4.9.0 认证 — 将内置的 MolocoSDKiOS 从 4.8.1 更新至 4.9.0。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXMolocoAdapter', '~> 4.9.0.0'。

iOS SDK — Moloco 适配器 4.8.1.0

变更

已通过 MolocoSDKiOS 4.8.1 认证 — 将内置的 MolocoSDKiOS 从 4.8.0 更新至 4.8.1。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXMolocoAdapter', '~> 4.8.1.0'。

iOS SDK — Pangle 适配器 8.3.0.6.0

变更

已通过 Ads-Global 8.3.0.6 认证 — 将内置的 Ads-Global 从 8.2.1.0 更新至 8.3.0.6。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXPangleAdapter', '~> 8.3.0.6.0'。

iOS SDK — Pangle 适配器 8.2.1.0.0

变更

已通过 Ads-Global 8.2.1.0 认证 — 将内置的 Ads-Global 从 8.2.0.9 更新至 8.2.1.0。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXPangleAdapter', '~> 8.2.1.0.0'。

iOS SDK — Pangle 适配器 8.2.0.9.0

变更

已通过 Ads-Global 8.2.0.9 认证 — 将内置的 Ads-Global 从 8.2.0.8 更新至 8.2.0.9。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXPangleAdapter', '~> 8.2.0.9.0'。

iOS SDK — Pangle 适配器 8.2.0.8.0

变更

已通过 Ads-Global 8.2.0.8 认证 — 将内置的 Ads-Global 从 8.2.0.7 更新至 8.2.0.8。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXPangleAdapter', '~> 8.2.0.8.0'。

CloudX CLI 0.38

竞价方拆分报表

CloudX CLI 0.38 新增竞价方自定义报表维度，可按竞价方查看投放和点击指标。

新增

竞价方维度 — 对于 2026 年 6 月 1 日或之后开始的时间段，可在 cloudx report breakdown --by 中使用 bidder，并可与 app、format 和 ad_unit 组合进行需求方分析。
竞价方投放指标 — 可请求 bid_requests、fills、impressions、revenue、clicks 和比率。requests 仍表示广告请求数，并会在竞价方行中重复；请使用 bid_requests 查看发送给每个竞价方的请求数。阅读文档 →

cloudx report breakdown --by bidder,app,format,ad_unit --metrics requests,bid_requests,fills,impressions,clicks,ctr

GET /report/breakdown 支持将 bidder 作为 by 维度，适用于 2026 年 6 月 1 日或之后开始的时间段。可将其与 app、format 和 ad_unit 组合，以获取竞价方级别的竞价请求、填充、展示、收入、点击和比率。requests 仍表示广告请求数，并会在竞价方行中重复；请使用 bid_requests 查看发送给每个竞价方的请求数。

2026年9月11日

iOS
Flutter
Unity

iOS SDK — Unity Ads 适配器 4.17.0.0

新增

面向 Unity Ads 4.17.0 的兼容线版本 — 基于 4.19.0.0 适配器重新构建以适配 Unity Ads 4.17.0，功能集相同，未修改源码。支持 Banner、MREC、插屏和激励视频，并提供广告过期回调。安装：pod 'CloudXUnityAdsAdapter', '4.17.0.0'；需要 CloudXCore >= 3.5.0。

iOS SDK — Vungle 适配器 7.7.1.0

新增

面向 Vungle Ads SDK 7.7.1 的兼容线版本 — 基于 7.7.6.0 适配器重新构建以适配 Vungle Ads SDK 7.7.1，功能集相同，未修改源码。安装：pod 'CloudXVungleAdapter', '7.7.1.0'；需要 CloudXCore >= 3.5.0。

Flutter SDK 3.9.0

将插件迁移到当前的 CloudX 原生 SDK，并新增 Trusted Arbiter。Dart 包版本跟随 iOS CloudXCore 线；Android 的 io.cloudx:sdk 固定版本随每个版本一并列出。

原生版本固定

iOS： CloudXCore 3.9.0
Android： io.cloudx:sdk 4.7.0

API

CloudX.initialize 返回 CloudXInitializationResult。请检查 result.success；失败时会带上原生 SDK 的错误码、错误码名称和错误信息，因此可以区分应用密钥错误与网络失败。
单次加载的额外参数：setBannerExtraParameter、setMrecExtraParameter、setInterstitialExtraParameter 和 setRewardedExtraParameter 可为该广告单元的下一次加载附加一组键值。参见单次加载的额外参数。
CloudXError.codeName 会带上 SDK 为该错误码定义的名称，因此日志会显示为 NO_FILL[302] 而不是 302。初始化失败则由 CloudXInitializationResult.errorCodeName 提供同样的信息。
新增错误码：CloudXErrorCode.adNotFound（403）表示展示时找不到该广告单元的广告，displayHostUnavailable（404）表示没有可用于展示的宿主。
新增加载错误码：loadNotAllowedWhileShowing（303）和 loadFailed（304），以及广告单元在已有加载进行中时可能返回的拒绝，Android 编号为 305，iOS 为 306。这两个都要处理，因为两个平台互不上报对方的值。

Trusted Arbiter

CloudX.arbiter 会把已加载的 CloudX 广告与您自行接入平台的出价进行比较，并返回应当展示的平台。出价工厂覆盖 CloudX、AdMob、Google Ad Manager、Unity LevelPlay、PubMatic 和自定义来源。参见 Trusted Arbiter。
CloudX.reportRevenueData 把其他中介平台的展示收入转发给 CloudX。AdMob 和 Ad Manager 的出价依赖这些历史数据定价，因此该接口是必需的。
CloudXAd.adValues 暴露 SDK 附加在已加载广告上的元数据。请把 onAdLoaded 中的 CloudXAd 原样传给 CloudXArbiterBid.cloudX。

广告行为

iOS： 全屏广告从最顶层的视图控制器展示；在系统 UI（如弹窗或分享面板）之上的展示会被拒绝，并在失败信息中给出原因。
测试模式下不回调收入，测试用的哨兵价格不会进入您的收入监听器。
此前广告事件若缺少字段或字段类型异常，会在到达监听器之前被丢弃。现在该回调会正常送达，并把缺失字段标记为不存在。

宿主应用：网络适配器

发布的插件仅包含核心。适配器按 <网络 SDK 版本>.<适配器修订号> 独立编号，与核心 SDK 各自演进，因此适配器版本无需与插件版本一致。Flutter 集成指南 说明在何处声明适配器，并链接到列有当前版本和各网络要求的 Android 与 iOS 指南。

广告格式

本次发布支持横幅广告、MREC、插屏广告和激励视频广告。横幅广告和 MREC 以程序化浮层展示；插屏广告和激励视频广告则通过程序化 API 加载和展示。参见横幅广告和 MREC、插屏广告和激励视频广告。

Unity SDK 4.7.0

SDK 更新

将 Android SDK 从 4.6.0 更新至 4.7.0 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.8.0 更新至 3.9.0 — 详情请参阅 iOS SDK 更新日志
新增 Android BIGO Ads 适配器。在 Assets/CloudXSdk/Editor/CloudXDependencies.xml 中取消注释 io.cloudx:adapter-bigo:6.0.1.0 即可启用。请参阅 BIGO Ads。
将 Android MobileFuse 适配器从 1.11.0.1 更新至 1.12.0.0。
将 iOS Mintegral 适配器从 8.1.5.0 更新至 8.1.6.0。
将 iOS Vungle 适配器从 7.7.4.0 更新至 7.7.6.0。

2026年9月10日

iOS
Dashboard

iOS SDK 3.9.0

安装：pod 'CloudXCore', '~> 3.9'

破坏性变更

同一广告位的第三个并发 load() 现在会被拒绝 — 每个广告位默认最多允许两个由发布者触发的并发加载。第三个会通过 didFailToLoadAd: 失败。如需提高上限，请联系 CloudX。
全屏广告展示期间调用 load() 不再失败 — 在插屏、激励或应用打开广告展示期间请求的加载现在会排队等待，并在该广告关闭后开始。请移除针对旧的立即失败行为的重试逻辑。
自动刷新运行期间手动调用 Banner load() 会被忽略 — 在自动刷新开启且已有广告展示时，load() 不会发起竞价，也不会触发任何委托回调，而是记录一条警告。如需自行驱动刷新，请先调用 stopAutoRefresh。

新增

视频素材现在可在 Banner 和 MREC 广告位内嵌渲染 — 内嵌视频通过专用渲染器在广告位内播放。它以静音状态开始，且仅在广告位真正可见时播放。自动刷新会暂停直至播放完成。
可选的广告缓存与预加载 — 已竞得但未展示的广告可以在其广告对象被销毁后保留，并提供给同一广告位的下一个对象；展示也可以触发下一个广告的后台获取。两者均默认关闭，需由 CloudX 为您的账户启用。
CLXNativeAd 新增 shouldPrepareViewForInteractionOnMainThread — 在自定义原生广告上重写该方法，以声明视图准备是否必须在主线程执行。默认值为 YES，与现有行为一致。

变更

冷启动首次竞价更快 — 竞价 token 现在在每个适配器完成初始化时收集，而不是等到首次竞价发起时才收集，因此首次广告请求返回更快。实测首次竞价耗时减少 230–272 毫秒。
由 CloudX 关闭的自动刷新将保持关闭 — 当某个广告位的自动刷新在 CloudX 侧被关闭后，startAutoRefresh() 不再重新启用它。load() 仍然可用，使用 stopAutoRefresh() 暂停或恢复的行为不受影响。
Banner 仅在真正可见时刷新 — 处于隐藏、完全透明、尺寸为零或不在可见窗口中的 Banner 会停止请求新广告，直到重新出现在屏幕上。预期加载请求减少，每次加载的展示率提高。
生成的原生模板视图现在根据素材尺寸计算 — 原生模板视图的高度现在由素材宽高比和您提供的宽度决定，而不再是固定的 320x250。请通过 -sizeThatFits: 读取高度；硬编码高度会裁切广告。
固定尺寸的原生模板仍然可用 — +[CLXNativeAdView viewFromAd:withTemplate:] 搭配 medium_template 保持不变，仍然返回 320x250。

修复

短暂中断后 Banner 自动刷新会恢复 — 控制中心、来电或面容 ID 提示可能导致 Banner 的自动刷新在会话剩余时间内停止。现在当您的应用重新变为活跃状态时，刷新会恢复。
已有模态视图时全屏广告能正确展示 — showFromViewController: 现在会解析最顶层的视图控制器，而不是直接失败。广告绝不会展示在系统 UI（如弹窗或分享面板）之上，并且会报告拒绝原因。
测试模式会话不再上报收入 — 测试会话以占位价格填充，因此这些数值不再发送到您的收入回调，也不再转发给您的归因服务商。正式会话不受影响。
您请求的原生模板现在会送达竞价 — 您请求的原生模板会随竞价请求发送，使竞价方能够返回匹配的素材。此前该请求在离开 SDK 前就被丢弃。

Dashboard — 总收入中的 AdMob 收入只计一次

通过 AdMob estimated 竞价方投放的 Google 需求，此前在总收入中被统计两次：一次来自 CloudX，另一次来自您自己的 AdMob 报表。现在，仪表板会按已映射的 AdMob 广告单元和日期，从对应的 AdMob 行中扣除 CloudX 已记录的收入，使其只在 CloudX 名下计一次。这些行只显示未经由 CloudX 投放的 Google 流量，且当 CloudX 记录的金额更多时会归零而不会出现负数。自动定价读取的仍是您完整的 AdMob 报表数据。

2026年9月9日

Android

Android SDK 4.7.0

新增

MREC 视频 - CloudX 渲染的 MREC 广告现支持内嵌 VAST 视频。视频默认静音播放，广告移出屏幕时暂停。
全屏广告预加载 - 在 CloudX 配置中启用后，展示全屏广告可为同一广告单元预加载下一条广告。
BIGO Ads 适配器可用 - BIGO Ads Android 适配器现已发布为 io.cloudx:adapter-bigo:6.0.1.0，在 CloudX Android SDK 4.7.0 或更高版本中支持 Banner、MREC、Interstitial 和 Rewarded 广告格式。

变更

内嵌视频音频 - CloudX 渲染的横幅和 MREC 广告中的 HTML/MRAID 视频现默认静音。用户可通过视频控件取消静音。
并发加载 - 每个广告单元默认最多允许两个发布商加载请求同时进行，限制可通过配置调整。超出限制的请求会返回 CloudXErrorCode.LOAD_REJECTED_CONCURRENCY；请等待正在进行的加载完成后再重试。
展示期间加载 - 在全屏广告展示期间调用 load() 会排队一个请求，待广告关闭后执行。重复调用不会增加排队请求。
测试模式收入 - 测试会话不再触发单个广告或全局收入回调，也不会向连接器发送收入通知。展示和奖励事件仍可用。
初始化性能 - 减少 SDK 初始化期间的主线程工作，并改善首次广告请求的准备流程。

修复

首次加载可靠性 - 改善网络初始化期间的广告加载，并减少广告请求前重复的准备工作。
原生广告渲染 - 原生广告无法完成点击和展示注册时，加载现会失败，不再返回无法正常使用的广告。
横幅刷新控制 - 在 CloudX 配置中禁用自动刷新后，即使应用调用 startAutoRefresh()，禁用设置仍然有效。
设备识别 - 修复将 Android 真机错误识别为模拟器的问题。

2026年9月8日

iOS SDK — Vungle 适配器 7.7.6.0

变更

已通过 VungleAds 7.7.6 认证 — 将内置的 VungleAds SDK 从 7.7.4 更新至 7.7.6。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXVungleAdapter', '~> 7.7.6.0'。

iOS SDK — Mintegral 适配器 8.1.6.0

变更

已通过 MintegralAdSDK 8.1.6 认证 — 将内置的 MintegralAdSDK 从 8.1.5 更新至 8.1.6。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXMintegralAdapter', '~> 8.1.6.0'。

2026年9月7日

iOS SDK — Pangle 适配器 8.1.0.6.0

新增

面向 Pangle Ads-Global 8.1.0.6 的兼容线版本 — 8.2.0.7.0 适配器针对 Ads-Global 8.1.0.6 重新构建，功能集相同，源码未改动。安装：pod 'CloudXPangleAdapter', '8.1.0.6.0'；要求 CloudXCore >= 3.5.0。

iOS SDK — Pangle 适配器 8.1.0.7.0

新增

面向 Pangle Ads-Global 8.1.0.7 的兼容线版本 — 8.2.0.7.0 适配器针对 Ads-Global 8.1.0.7 重新构建，功能集相同，源码未改动。安装：pod 'CloudXPangleAdapter', '8.1.0.7.0'；要求 CloudXCore >= 3.5.0。

2026年9月5日

iOS SDK — Moloco 适配器 4.7.0.0

新增

面向 MolocoSDKiOS 4.7.0 的兼容线版本 — 4.8.0.0 适配器针对 MolocoSDKiOS 4.7.0 重新构建，功能集相同，源码未改动。安装：pod 'CloudXMolocoAdapter', '4.7.0.0'；要求 CloudXCore >= 3.5.0。

2026年9月2日

iOS
Demand

iOS SDK — Google Waterfall 适配器 12.12.0.0

新增

面向 Google Mobile Ads SDK 12.12.0 的兼容线版本（12.12.0） — 12.14.0.3 适配器针对 Google Mobile Ads SDK 12.12.0 重新构建，功能集相同，源码未改动。安装：pod 'CloudXGoogleWaterfallAdapter', '12.12.0.0'；要求 CloudXCore >= 3.7.0。

需求 — Intent IQ 透传

CloudX 现在会通过 intentiq.com 转发发布商提供的 Intent IQ ID，使用 atype: 1。

发布商通过 setUserKeyValue("intentiq.com", id) 传入该 ID，无需升级 SDK。
CloudX 原样传递该 ID，不运行 Intent IQ 服务端解析。需求合作伙伴通过 Intent IQ 合作关系激活 intentiq.com ID。

阅读扩展标识符文档 →

2026年9月1日

Unity

Unity SDK 4.6.1

新功能

新增 CloudXSdk.InvokeEventsOnUnityMainThread，用于控制 CloudX 回调在哪个线程上触发。设为 true 表示 Unity 主线程，设为 false 表示原生回调线程，不设置则使用默认行为。请参阅回调线程。

修复

广告回调不再丢失。抛出异常的处理器现在会连同事件名称和出错的处理器一起记录日志，而不会静默中断其余处理器。
展示尚未就绪的插屏、激励或开屏广告时，现在会回调 OnAdShowFailed，而不是毫无反应。
Banner 或 MREC 在首次加载成功后刷新失败时，现在会回调 OnAdLoadFailed。
ReportRevenueData 现在会记录负载被拒绝的原因，便于修正无效的收益值、广告格式或平台名称。

SDK 更新

将 iOS TaurusX 适配器从 1.18.1.0 更新至 1.18.2.0。

2026年8月28日

iOS SDK — TaurusX 适配器 1.18.2.0

变更

已通过 TaurusX SDK 1.18.2 认证 — 将内置的 TaurusX SDK 从 1.18.1 更新至 1.18.2。无需修改集成代码；CloudXCore >= 3.5.0 与 iOS 13.0 保持不变。安装：pod 'CloudXTaurusXAdapter', '~> 1.18.2.0'。

iOS SDK — Mintegral 适配器 8.1.3.0

新增

8.1.5.0 适配器针对 MintegralAdSDK 8.1.3 的向后移植版本 — 兼容线版本，支持的格式与 8.1.5.0 相同（Banner、MREC、插屏、激励、原生和开屏）。安装：pod 'CloudXMintegralAdapter', '8.1.3.0'；要求 CloudXCore >= 3.5.0。

iOS SDK — Meta 适配器 6.20.1.0

变更

Audience Network 6.20.1 兼容版本 — 适用于固定使用 Audience Network 6.20.1 的应用，保留 iOS 13 支持。此版本不支持原生视频选项和 AdChoices 关闭回调。安装：pod 'CloudXMetaAdapter', '6.20.1.0'；要求 CloudXCore >= 3.5.0。

iOS SDK — Vungle 适配器 7.6.3.0

变更

VungleAds 7.6.3 兼容版本（7.6.3） — 适用于中介堆栈固定使用 VungleAds 7.6.3 的应用，与当前版本行为一致。安装：pod 'CloudXVungleAdapter', '7.6.3.0'；要求 CloudXCore >= 3.5.0。

iOS SDK — Unity Ads 适配器 4.16.3.0

变更

UnityAds 4.16.3 兼容版本 — 适用于固定使用 UnityAds 4.16.3 的应用。CLXUnityAdsRewarded 依据展示完成状态发放奖励，且不支持广告过期回调。安装：pod 'CloudXUnityAdsAdapter', '4.16.3.0'；要求 CloudXCore >= 3.5.0。

iOS SDK — Mintegral 适配器 8.0.3.0

变更

MintegralAdSDK 8.0.3 兼容版本（8.0.3） — 适用于中介堆栈固定使用 Mintegral 8.0.3 的应用，与当前版本行为一致。安装：pod 'CloudXMintegralAdapter', '8.0.3.0'；要求 CloudXCore >= 3.5.0。

2026年8月27日

React Native

React Native SDK 3.8.0

CloudX React Native 3.8.0 使包装层与 CloudX iOS 3.8.0 和 Android 4.6.0 对齐，更新原生适配器设置版本，并修复两个 Android 调用顺序问题。JavaScript API 保持不变。

变更

底层原生 SDK 版本更新为 iOS CloudXCore ~> 3.8.0 和 Android io.cloudx:sdk:4.6.0。
(iOS) Meta 适配器 - 设置更新为 pod 'CloudXMetaAdapter', '~> 6.22.0.0'。
(iOS) InMobi 适配器 - 设置更新为 pod 'CloudXInMobiAdapter', '~> 11.4.1.0'。
(iOS) MobileFuse 适配器 - 设置更新为 pod 'CloudXMobileFuseAdapter', '~> 1.11.0.1'。
Google 适配器 - 设置更新为 iOS CloudXGoogleWaterfallAdapter ~> 13.6.0.4、Android io.cloudx:adapter-googlewaterfall:25.2.0.5 和 Android GMA Next-Gen io.cloudx:adapter-admob:1.3.0.4。
(Android) Digital Turbine 适配器 - 设置更新为 io.cloudx:adapter-digitalturbine:8.4.7.1。

修复

(Android) 广告调用按调用顺序执行 - 插屏、开屏和激励方法此前可能乱序执行。销毁广告后立即重新加载时，加载结果可能永远不会回调到 JavaScript。
(Android) Banner 与 MREC 位置 - 先设置位置再设置偏移量时，位置不再被还原为先前的值。

平台支持

iOS：CloudXCore ~> 3.8.0
Android：io.cloudx:sdk:4.6.0

2026年8月26日

iOS
Unity

iOS SDK — Google Waterfall 适配器 12.14.0.3

Changed

Google 适配器的启动不再拖慢 CloudX SDK 初始化（12.14.0） — 与 13.6.0.4 相同的改动，面向 Google Mobile Ads SDK 12.14.0。安装：pod 'CloudXGoogleWaterfallAdapter', '12.14.0.3'；要求 CloudXCore >= 3.7.0。

iOS SDK — Google Waterfall 适配器 13.6.0.4

变更

Google 适配器的启动不再拖慢 CloudX SDK 初始化 — Google Mobile Ads SDK 现在改为在后台启动，不再占用您的 initialize 调用时间。若 Info.plist 中缺少 GADApplicationIdentifier，初始化仍会立即失败。
初始化后紧接着请求的广告可能出现一次无填充 — Google 需求会在后台启动完成后就绪。在此之前发出的请求不会等待，而是对该次请求快速返回无填充，下一次请求即可正常投放。
要求 Google Mobile Ads SDK 版本严格为 13.6.0；要求 CloudXCore 3.7.0 或更高版本。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.4'。

Unity SDK 4.6.0

修复

iOS Banner 和 MREC 现在在展示时立即渲染，不再等到下一次刷新之前一直保持空白。

SDK 更新

将 Android SDK 从 4.5.1 更新至 4.6.0 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.7.0 更新至 3.8.0 — 详情请参阅 iOS SDK 更新日志
更新 Android Google Waterfall、AdMob 和 Magnite 适配器版本。
更新 iOS Google Waterfall、InMobi 和 MobileFuse 适配器版本。

2026年8月24日

iOS
Dashboard

iOS SDK 3.8.0

安装：pod 'CloudXCore', '~> 3.8'

新增

Banner 和 MREC 广告中的视频默认静音 — Banner 和 MREC 广告位中的视频素材以静音状态开始播放；素材只能在用户点击其自身控件后取消静音。
Google Ad Manager Prebid 集成 — 现已发布为 pod 'CloudXGAMPrebid', '~> 1.0'，可让 CloudX 需求以 prebid 订单项的形式参与您的 Google Ad Manager 竞价，支持 Banner、MREC、插屏、激励和原生格式。要求 CloudXCore 3.8.0 或更高版本。

修复

收入和点击回调始终送达 — 出价元数据不完整的广告可能在正常展示和产生收入的同时，静默跳过收入和点击回调。这些回调现在始终触发，使您的 ILRD 与 CloudX 报表一致。
对可见 Banner 调用 load() 不再泄漏被替换的广告 — 发布者通过 load() 主动刷新 Banner/MREC 时，被替换广告的 WebView 和媒体资源会在会话剩余时间内泄漏。被替换的广告现在会正确销毁。
可见性测量启动失败时仍统计视频展示 — 部分 VAST 视频广告正常渲染播放但从未计为展示。现在它们会正确计费并触发跟踪信标。
不再丢弃过长的跟踪 URL — 最长 10KB 的 VAST 跟踪信标 URL 现在会正常触发；此前超过 2KB 的 URL 会被静默丢弃。
并发网络响应处理更快 — 网络请求完成回调不再逐一串行处理，单个缓慢的响应不会再拖延初始化和竞价期间其他已完成的请求。

iOS SDK — MobileFuse 适配器 1.11.0.1

修复

读取 MobileFuse SDK 版本号不再阻塞调用线程 — 消除了竞价 token 路径上的卡顿。MobileFuseSDK 1.11.0 与 CloudXCore >= 3.5.0 保持不变。安装：pod 'CloudXMobileFuseAdapter', '~> 1.11.0.1'。

Dashboard — 竞价方漏斗报表

在报表页面切换竞价漏斗与竞价方漏斗。

报表现在除已有的**竞价漏斗（Auction Funnel）之外，还可以按竞价方漏斗（Bidder Funnel）**查看。点击日期控件上方的报表标题即可切换。

竞价漏斗中每个广告请求对应一行，因此竞价方只有在竞得展示后才会出现。竞价方漏斗按参与竞价的竞价方拆分同一批竞价，补齐了此前缺失的分母：每个竞价方被询价的频率、响应的频率，以及未竞得时的出价情况。您可以按应用、竞价方、广告格式、操作系统、国家/地区、优先级、广告单元、轮次、出价结果和 SDK 错误进行细分。

阅读文档 →

2026年8月23日

Android

Android SDK 4.6.0

新增

Google Ad Manager Prebid 集成 - 现已发布为 io.cloudx:integration-gam-prebid:1.0.0，可让 CloudX 需求以 prebid 订单项的形式参与您的 Google Ad Manager 竞价，支持 Banner、MREC、插屏、激励和原生格式。要求 CloudX Android SDK 4.6.0 或更高版本。

变更

首次竞价性能 - 通过在 SDK 初始化期间启动 CloudX 连接，减少首次竞价前的网络准备时间。

2026年8月21日

iOS
Demand

iOS SDK — Google Waterfall 适配器 13.6.0.3

变更

全屏广告通过 Google 的广告预加载 API 预取 — 插屏、激励视频和开屏广告由 Google Mobile Ads SDK 预加载，而非适配器；CLXGoogleWaterfallFullscreenLoader 已移除。Banner、MREC 和原生广告不受影响，发布者无需任何操作。
要求 Google Mobile Ads SDK 版本严格为 13.6.0；要求 CloudXCore 3.7.0 或更高版本。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.3'。

需求 — EUID 透传

CloudX 现在会通过 euid.eu 转发发布商提供的 EUID 广告 token。EUID 是 UID2 的欧洲版本，使用 atype: 3。

发布商通过 setUserKeyValue("euid.eu", token) 传入广告 token，无需升级 SDK。
CloudX 原样传递 token。获得授权的需求合作伙伴通过 EUID 竞价流集成解密。

阅读扩展标识符文档 →

2026年8月20日

Demand
Dashboard

需求 — 扩展标识符

CloudX 现在会在竞价请求中转发发布商提供的 UID 2.0、LiveRamp 和 ID5 值。发布商通过现有的 setUserKeyValue API 传入这些值，无需升级 SDK。

发布商使用的键为 uidapi.com（UID2 广告 token）、liveramp.com（LiveRamp ATS 信封，不是 RampID）和 id5-sync.com（ID5 通用 UID）。
OpenRTB 2.6 竞价方读取 user.eids。OpenRTB 2.5 竞价方读取 user.ext.eids。
CloudX 不会生成、解密或替换这些值，也不运行 LiveRamp Sidecar。

发布商配置： Android、iOS、Unity、React Native 和 Flutter

需求合作伙伴配置： 阅读扩展标识符文档 →

Dashboard — 弃用广告跟踪 YAML 字段

清单 YAML 不再接受 target 下的广告跟踪字段，包括 att_status、attStatus、 att、exclude.att 和 exclude.att_status。发布商应移除这些已弃用字段，而不是将其值迁移到 ifa_present，因为跟踪权限与标识符是否存在是不同的信号。仅在需要新的广告标识符存在状态定向时使用 ifa_present。

2026年8月18日

Android
iOS
Unity

Android SDK 4.5.2

变更

Play SDK Console 验证 - 已发布的 Android SDK 制品现在包含在 Google Play SDK Console 中完成所有权验证所需的元数据。

Android SDK 4.5.1

修复

竖向 Banner 可靠性 - 旋转后的 Banner 现在能够正确上报可见性曝光和 MRAID 位置，从而在封装 SDK 集成中可靠支持左侧和右侧竖向 Banner 广告位。
VAST 展示跟踪 - 现在可发送最长 10 KB 的 VAST 跟踪 URL，避免带有较长查询参数的有效展示信标被丢弃。
Banner 广告位中的原生视频 - 无法在 320x50 广告位中显示的原生视频广告现在会被拒绝，不再产生不可见展示，并允许继续尝试后备需求。

iOS SDK — InMobi 适配器 11.4.1.0

变更

已通过 InMobiSDK 11.4.1 认证 — 改进了 MRAID 3 素材的音频处理，广告不再中断应用正在播放的音频。要求 CloudXCore >= 3.5.0，保持不变。安装：pod 'CloudXInMobiAdapter', '~> 11.4.1.0'。

Unity SDK 4.5.1

新功能

新增 Vertical Banner 支持，让纵向空间有限的横屏应用也可以集成 Banner。使用 CloudXAdViewConfiguration.AdViewVerticalPosition.Left 和 .Right 可放置在屏幕左右边缘。

集成说明

使用 iOS Meta 适配器 6.22.0.0 的应用必须以 iOS 15 或更高版本为目标。仍需支持 iOS 13 或 14 的应用应继续使用 6.21.1.0。

SDK 更新

将 Android SDK 从 4.5.0 更新至 4.5.1 — 详情请参阅 Android SDK 更新日志
更新 Android Mintegral、Google Waterfall、Digital Turbine 和 AdMob 适配器版本。
将 iOS Meta 适配器从 6.21.1.0 更新至 6.22.0.0。

2026年8月12日

iOS SDK — Meta 适配器 6.22.0.0

变更

要求 iOS 15 — 已通过 Meta Audience Network 6.22.0 认证，该版本要求 iOS 15.0。仍需支持 iOS 13 或 14 的应用应继续使用 6.21.1.0。安装：pod 'CloudXMetaAdapter', '~> 6.22.0.0'。
Meta 新增广告格式 — Audience Network 6.22 新增电商和商品目录格式、iOS 端连续广告以及可玩广告改进。这些格式由 Meta 投放；除更新适配器外无需更改集成代码。

CloudX CLI 0.37

统一活动导出

CloudX CLI 0.37 新增统一命令组，用于异步导出全天的展示、请求和出价活动。

新增

统一导出命令 — 使用 cloudx export impressions、cloudx export requests 和 cloudx export bids。现有 cloudx report impressions export 命令仍可用于兼容旧工作流。
请求活动导出 — 每个竞价请求导出一行，包含请求结果和竞价方漏斗字段。阅读文档 →
出价活动导出 — 导出出价、未出价、超时和错误记录。获胜价格会保留，落败价格会被隐去。使用 --bids-only 可仅包含出价响应。阅读文档 →
异步下载 — 可导出过去 45 天内已结束的 UTC 日期，支持精细过滤，并可通过 --wait 或 --output <路径> 获取结果。

CloudX API — 活动导出

公共 API 现已支持异步导出全天的展示、请求和出价活动。

新增

统一导出端点 — 通过 POST /export/impressions、POST /export/requests 和 POST /export/bids 创建或复用导出，再轮询对应的 GET 端点以获取状态和短期有效的下载 URL。
请求与出价活动 — 请求导出包含竞价结果和竞价方漏斗字段。出价导出包含出价、未出价、超时和错误记录，落败价格会被隐去。请求导出文档 → 出价导出文档 →

2026年8月11日

iOS
React Native
Unity

iOS SDK 3.7.0

安装：pod 'CloudXCore', '~> 3.7'

新增

Trusted Arbiter 支持 AdMob 与 Google Ad Manager 竞价 — 新增 CLXArbiterBid 工厂方法 adMob(adUnitId:) 与 gam(adUnitId:)，无需提供价格即可将 Google 需求加入仲裁：CloudX 会根据您通过 reportRevenueData(_:) 上报的收入自动定价。同时支持可选的按次展示美元收入覆盖值。
CLXRevenuePlatformGAM — 可通过 reportRevenueData(_:) 上报 Google Ad Manager 收入；GAM 付费事件现在也会用于仲裁竞价定价。

变更

面向适配器的 CLXBidRoute 原生路由 — CloudX 适配器使用的头文件新增原生路由支持（CLXBidRoute、CLXNativeParsedAdKey）。仅供 CloudX 适配器内部使用；发布者无需任何操作。

修复

仅集成核心 SDK 的应用可正常初始化 — 未安装任何适配器 Pod、仅集成 CloudXCore 的应用此前初始化失败（错误 201）且无法进行竞价，现均已修复。
Banner 与 MREC 视图不再泄漏 — 自动刷新的内嵌广告视图可能在整个会话期间被持续持有，导致长时间运行的应用内存无限增长。现在会正确释放。
未调用 destroy() 释放广告时也会清理资源 — 在不调用 destroy() 的情况下释放广告对象的最后一个引用，现在会正确销毁广告及其资源；此前会静默泄漏。
修复广告清理期间的罕见崩溃 — 释放广告资源时的一个窄范围内部竞态可能导致进程中止。
竖版原生素材按其上报的宽高比渲染 — SDK 原生模板中的竖版（如 9:16）素材不再被压在横向容器中出现黑边。竖版素材的模板视图现在更高（320x548，此前为 320x250）。
无竞价结果不再以 ERROR 级别记录日志 — 正常的无竞价结果现在以 DEBUG 级别记录，错误日志与崩溃监控告警只反映真实故障。

iOS SDK — Google Waterfall 适配器 13.6.0.2

新增

Google Ad Manager 需求 — CLXGoogleWaterfallPlacementTypeGam 类型的广告位通过 GAM 请求接口加载（Banner、MREC、插屏），并基于已实现的 GAM 收入历史进行收入衡量。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.2'；需要 CloudXCore >= 3.7.0。

变更

已实现价格的记录迁移至 CloudXCore — 适配器中的 CLXGoogleWaterfallRealizedPriceStore 头文件已移除；CloudXCore 3.7.0 使用相同的存储键继续维护该历史记录。发布者无需任何操作。

iOS SDK — Google Waterfall 适配器 12.14.0.2

新增

Google Ad Manager 需求（12.14.0） — 与 13.6.0.2 相同的支持（CLXGoogleWaterfallPlacementTypeGam 广告位；CLXGoogleWaterfallRealizedPriceStore 已迁移至核心），面向 Google Mobile Ads SDK 12.14.0 构建。安装：pod 'CloudXGoogleWaterfallAdapter', '12.14.0.2'；需要 CloudXCore >= 3.7.0。

React Native SDK 3.7.0

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

Unity SDK 4.5.0

新功能

新增 Trusted Arbiter 对 AdMob 和 Google Ad Manager 出价的支持，可使用 CloudXArbiterBid.AdMob(...) 与 CloudXArbiterBid.Gam(...)。CloudX 可根据已上报收益自动定价。
新增 CloudXRevenuePlatform.Gam，应用可通过 CloudXSdk.ReportRevenueData(...) 转发 Google Ad Manager paid event。
新增 Google Waterfall Unity 适配器对 Google Ad Manager 需求的支持；CloudX 配置会按广告位选择 AdMob 或 GAM。
新增 Android 和 iOS 的 TaurusX 适配器支持。
新增可选 Adjust 和 AppsFlyer 广告收入连接器，Unity 应用无需编写 C# 胶水代码即可将 CloudX 竞得展示收入转发给 MMP。

集成说明

使用 Meta 适配器 6.22.0.0 的 Android 项目必须以 Android API 36 编译，因为 Meta Audience Network 6.22.0 依赖 androidx.browser:1.9.0。

SDK 更新

将 Android SDK 从 4.4.0 更新至 4.5.0 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.6.0 更新至 3.7.0 — 详情请参阅 iOS SDK 更新日志
将 Google Waterfall 适配器版本更新至 Android 25.2.0.2 和 iOS 13.6.0.2。
将 Android Meta 适配器更新至 6.22.0.0，并将可选 Android AdMob 适配器更新至 1.3.0.1。

2026年8月10日

Android

Android SDK 4.5.0

新增

通过 TPA 支持 AdMob 与 Google Ad Manager 需求 - 通过第三方仲裁新增 AdMob 和 Google Ad Manager 需求，使用 CloudXArbiterBid.adMob(adUnitId) 与 CloudXArbiterBid.gam(adUnitId)。竞价可根据实际收益自动定价，也可通过 manualRevenuePerImpressionUSD 手动定价。
Google 适配器支持 Google Ad Manager - 现有 Google 适配器现在可与 AdMob 并行投放 Google Ad Manager 需求，按广告位通过 CloudX 配置选择，无需修改代码。
Banner 与 MREC 原生测试广告 - CloudX 测试广告现在可在 Banner（320x50）和 MREC（300x250）广告位中渲染原生素材。

修复

全屏广告回调可靠性 - 修复展示插屏或激励广告时可能重放过期错误的竞争问题；广告销毁后到达的广告网络回调现在会被安全处理。
Digital Turbine 原生展示 - Digital Turbine 原生广告现在会正常触发展示和收益回调。需要更新后的 Digital Turbine 适配器。

2026年8月3日

iOS
React Native
Unity

iOS SDK — TaurusX 适配器 1.18.1.0

新增

TaurusX 适配器 — 新增 CloudXTaurusXAdapter，支持 Banner、MREC、插屏、激励和原生广告。安装：pod 'CloudXTaurusXAdapter', '~> 1.18.1.0'。基于 TaurusX SDK 1.18.1；需要 CloudXCore >= 3.5.0。

React Native SDK 3.6.1

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

Unity SDK 4.4.1

新功能

新增 CloudXArbiterBid.Custom，支持没有专用出价类型的 mediation platform 参与 Trusted Arbiter。
新增 CloudXArbiterPlatform.Custom 和 CloudXArbiterResult.PlatformName，自定义出价获胜时可识别来源 mediation platform。

迁移说明

CloudXArbiterResult 现在包含 PlatformName；直接构造或解构该 record 的代码需要传入这个新值。

变更

重新生成 CloudX SDK 资源 GUID，避免导入 Unity 项目时发生资源冲突；程序集定义 GUID 保持不变。
更新 Unity Demo 的 Arbiter 验证按钮，可一次运行 CloudX、LevelPlay、PubMatic 和自定义出价场景。

SDK 更新

将 iOS Pangle 适配器从 7.9.1.3.0 更新至 8.2.0.7.0。

2026年7月30日

iOS
Dashboard

iOS SDK — Pangle 适配器 8.2.0.7.0

变更

Pangle CloudXPangleAdapter → ~> 8.2.0.7.0（Ads-Global 8.2.0.7）。安装：pod 'CloudXPangleAdapter', '~> 8.2.0.7.0'；需要 CloudXCore >= 3.5.0。

Dashboard — 总收入仪表板

总收入仪表板。

总收入将 CloudX 与已连接聚合平台的效果汇总到同一个仪表板中，让您可以在一处比较整体广告变现结果。阅读文档 →

2026年7月29日

iOS
React Native
Unity

iOS SDK — Google Waterfall 适配器 12.14.0.1

修复

预取的 Google 广告可能在过期后仍被展示（12.14.0） — 13.6.0.1 修复的回移，面向 Google Mobile Ads SDK 12.14.0；填充现在会在过期前刷新，防止空白渲染。安装：pod 'CloudXGoogleWaterfallAdapter', '12.14.0.1'；需要 CloudXCore >= 3.5.0。

React Native SDK 3.6.0

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

Unity SDK 4.4.0

新功能

新增 App Open 广告支持，可通过 CloudXSdk.LoadAppOpen、CloudXSdk.ShowAppOpen、CloudXSdk.IsAppOpenReady、CloudXSdk.DestroyAppOpen 和 CloudXAdsCallbacks.AppOpen 使用。
新增发布商收益上报 API：CloudXSdk.ReportRevenueData(CloudXRevenueData data)，支持 AdMob、InMobi、TopOn 和自定义平台名称。

修复

修复 Unity 主线程回调分发问题，避免原生回调在排入 Unity 工作时导致回调投递死锁。

SDK 更新

将 Android SDK 从 4.1.7 更新至 4.4.0 — 详情请参阅 Android SDK 更新日志
将 iOS CloudXCore 从 3.4.6 更新至 3.6.0
将 iOS Google Waterfall 适配器从 3.4.6 更新至 13.6.0.1
更新 Unity Demo 使用的 Android 适配器版本：Vungle 7.7.7.0、InMobi 11.4.0.1、Mintegral 17.1.71.0、Moloco 4.11.0.0、Verve 3.9.0.1、Google Waterfall 25.2.0.1、Digital Turbine 8.4.7.0 和 Pangle 8.2.0.4.0。

2026年7月28日

Android
iOS
React Native
Demand

Android SDK 4.4.0

新增

发布商收益平台 - 发布商上报收益时，现在除 AdMob 外还可使用 CloudXRevenuePlatform.INMOBI、CloudXRevenuePlatform.TOPON 或 CloudXRevenuePlatform.custom(name)，便于从更多中介和报告平台转发展示级收入。

变更

收益金额单位 - CloudXRevenueData.builder(platform, revenue, adFormat) 现在将 revenue 作为货币单位的 Double 传入，CloudXRevenueData.revenue 现在也是 Double。对于 AdMob AdValue.valueMicros，请先除以 1_000_000.0 再创建 CloudXRevenueData。

修复

电话网络权限检查 - SDK 现在会在读取电话网络类型前检查 phone-state 权限。
VAST 跟踪器兼容性 - 修复 VAST 事件跟踪器，避免在 SDK 支持的最低 Android 版本上调用仅 API 24 支持的集合方法。

iOS SDK 3.6.0

安装：pod 'CloudXCore', '~> 3.6'

新增

从您的聚合平台上报展示级别收入 — 通过 reportRevenueData(_:) 将付费事件转发至 CloudX。AdMob、InMobi 和 TopOn 为内置平台。
应用级广告收入代理 — 通过单个 CLXAdRevenueDelegate 接收每一次 CloudX 获胜展示的收入，无需在每个广告上单独设置。使用 addAdRevenueDelegate(_:) 注册。
AppsFlyer 广告收入连接器 — 将 CloudX 展示收入转发至 AppsFlyer。安装：pod 'CloudXAppsFlyerConnector', '~> 6.15.0.0'。需要 AppsFlyerFramework >= 6.15.0。
Adjust 广告收入连接器 — 将 CloudX 展示收入转发至 Adjust。安装：pod 'CloudXAdjustConnector', '~> 5.0.0.0'。需要 Adjust >= 5.0.0。

修复

横幅和中矩形创意在 CloudX 渲染器上可能渲染为空白 — 创意可能在首次加载和刷新后构建失败，表现为空白展示。这些创意现在可以正确渲染。
HTML 激励创意在 CloudX 渲染器上被拒绝 — 渲染器此前仅接受 VAST 激励创意，因此 HTML 激励广告无法加载。HTML 激励创意现在可以正常渲染。

移除

内部头文件从 CloudXCore.h 伞头文件中移除 — 内部实现头文件已从伞头文件中移除；它们均不可被链接，因此不影响任何集成。请通过 reportRevenueData(_:) 及公开的收入类型上报收入。

React Native SDK 3.4.7

新增 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

需求 — zstd 竞价压缩

CloudX 现已支持对与需求合作伙伴交换的 OpenRTB 竞价请求和竞价响应使用 zstd 压缩。

竞价请求可以通过 Content-Encoding: zstd 发送；仍支持 gzip。
当 CloudX 声明 Accept-Encoding: gzip, zstd 时，需求合作伙伴可以使用 gzip 或 zstd 响应。
请联系 CloudX，为您的竞价端点启用 zstd。

阅读文档 →

2026年7月27日

Dashboard

Dashboard — 广告位置覆盖值

现在，您可以在 Dashboard 中创建或编辑广告单元时，设置发送给竞价方的广告位置回传信号。

准确的位置回传信号可帮助竞价方了解广告在屏幕上的实际展示位置，从而更准确地评估竞价机会。

保持默认（推荐），即可使用 CloudX 当前的默认值：横幅广告发送 1（首屏），MREC 不发送位置回传信号，全屏广告格式发送 7（全屏）。
当广告的实际展示位置与默认值不符时，可选择 0 到 7 之间的值。
重新选择**默认（推荐）**即可清除已保存的覆盖值。

此设置只会更改发送给竞价方的 OpenRTB/AdCOM banner.pos 或 video.pos 字段，不会重新定位应用中的广告。阅读文档 →

Dashboard — 手动底价的 IFA 状态定向

手动订单项底价现在可以根据设备是否提供可用的广告标识符来定向请求。

选择不限 IFA，不限制 IFA 状态。
选择有 IFA，定向具有可用广告标识符的请求。
选择无 IFA，定向广告标识符为空字符串、仅含空白字符、不可用或为 nil UUID（00000000-0000-0000-0000-000000000000）的请求。
将 IFA 状态与国家/地区定向组合，为不同流量群体设置不同底价。

在 YAML 配置中，省略 ifa_present 表示不限 IFA，设置 ifa_present: true 表示有 IFA，设置 ifa_present: false 表示无 IFA。

2026年7月22日

Dashboard

Dashboard — CloudX Agent

CloudX Agent 现已通过 Ask CloudX 在整个 Dashboard 中提供。它会将当前页面作为上下文，并可处理广告库存、配置、报表、竞价数据和 CloudX 产品文档相关任务。

您可以用它：

分析定价机会，并按广告单元、国家或广告格式准备底价变更
创建、监控、结束和推广 A/B 测试
管理竞价方参与状态和广告网络映射
诊断 eCPM 和填充率变化
验证广告库存，并从 CSV 或电子表格文件导入配置
将已发布的变更追溯到具体配置版本、时间和操作人

配置变更需要先在对话中审查并明确批准，CloudX 才会进行验证和发布。阅读文档 →

2026年7月21日

Android
iOS

Android SDK 4.3.0

新增

AppsFlyer 广告收益连接器 - 新增托管式 AppsFlyer 连接器与全局 CloudX.addAdRevenueListener() API，一个依赖、无需胶水代码即可将 CloudX 广告收益转发到 AppsFlyer 或任意 MMP。监听器每次竞得展示时触发一次，覆盖所有广告格式。

变更

Google Waterfall Prefetch 过期 - 预取的 Google Waterfall 填充现在按格式设置过期时限（App Open 为 4 小时，其他格式为 1 小时）并主动重新填充，避免陈旧的缓存填充在展示时渲染空白或失败。
重复 load() 处理 - 在一次加载进行中时重复调用 load() 现在会在所有广告格式上以安全、一致的方式处理。此前快速重复的 Banner 和 MREC 加载可能取消进行中的竞价，导致应用无法获得填充。
创意报告 - 创意标识现在会包含在 Native 和基于 Mintegral 的广告位的展示与收益遥测中，使创意级报告更准确。

修复

初始化前的 load 回调 - 在初始化完成前发出的 Banner 和 MREC load() 调用现在会被排队并始终产生回调。此前此类调用可能被静默丢弃；初始化失败现在会作为加载失败上报，而不是无回调地挂起。
Native 展示收益 - 修复了一处计时问题：在 SDK 观察者订阅之前触发的 Native 展示可能丢失，导致发布商的收益回调不触发。影响同步触发展示的 Native 路径，例如 Moloco 独立 Native。
乐观加载 Banner 泄漏 - 修复了乐观加载的 Banner 在其后台创意加载派发之前被销毁时的适配器视图泄漏。

iOS SDK — Google Waterfall 适配器 13.6.0.1

修复

预取的 Google 广告可能在过期后仍被展示 — 预取的填充现在会在过期前于后台刷新，防止空白渲染。安装：pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.1'。需要 CloudXCore >= 3.5.0。

离线适配器版本（-core34）- 2026-07-16

为仍在使用 CloudXCore 3.4.x 的发布商提供的三个适配器离线构建版本。每个版本兼容 CloudXCore 3.4.5 或 3.4.6，不兼容 CloudXCore 3.5.x。请锁定所示的确切版本 — pod update 不会自动解析这些版本。

Google Waterfall — pod 'CloudXGoogleWaterfallAdapter', '13.0.0.0-core34'。基于 Google Mobile Ads SDK 13.0.0。需要 CloudXCore >= 3.4.6, < 3.5。
Unity Ads — pod 'CloudXUnityAdsAdapter', '4.16.5.0-core34'。基于 UnityAds 4.16.5。需要 CloudXCore >= 3.4.5, < 3.5。奖励在广告完整观看后发放；UnityAds 4.16.5 不提供广告过期回调，因此不会收到过期创意的信号。
Moloco — pod 'CloudXMolocoAdapter', '4.3.0.0-core34'。基于 MolocoSDKiOS 4.3.0。需要 CloudXCore >= 3.4.5, < 3.5。

2026年7月17日

CloudX CLI 0.36

展示级收入导出

CloudX CLI 0.36 新增异步的全天展示级收入导出，用于账户范围的数据分析与核对。

新增

展示级 CSV 导出 — 新增 cloudx report impressions export --date YYYY-MM-DD，用于创建或复用 gzip 压缩的 CSV，每一行对应一条展示记录。支持导出过去 45 天内已经结束的 UTC 日期。阅读当前文档 →
精细导出过滤 — 可按应用 ID 或包名、广告单元 ID、国家、设备 OS、竞价方、订单项以及生产/测试流量过滤。
异步下载工作流 — 使用 --wait 轮询任务状态，或使用 --output <路径> 等待任务完成并通过短期有效 URL 安全下载结果。

cloudx report impressions export --date 2026-07-16 --output ./impressions-2026-07-16.csv.gz

2026年7月8日

iOS SDK — MobileFuse 适配器 1.11.0.0

新增

MobileFuse 适配器 — 全新的 CloudXMobileFuseAdapter，支持横幅、MREC、插屏和激励广告。安装：pod 'CloudXMobileFuseAdapter', '~> 1.11.0.0'。基于 MobileFuse SDK 1.11.0；需要 CloudXCore >= 3.5.0。

2026年7月7日

Android
iOS

Android SDK 4.2.0

新增

App Open 广告 - 新增通过 CloudX.createAppOpen() 和 CloudXAdFormat.APP_OPEN 使用 App Open 广告的支持，适用于应用回到前台等广告场景。
发布商收益上报 - 新增 CloudX.reportRevenueData() 和 CloudXRevenueData，发布商可将 AdMob 展示级收入事件转发到 CloudX 报告链路。
Trusted Arbiter 自定义出价 - 新增 CloudXArbiterBid.custom()、CloudXArbiterPlatform.CUSTOM 和 CloudXArbiterPrecision，支持与具体中介平台无关的自定义出价输入。
扩展 Google Waterfall 支持 - 新增 Google Waterfall Interstitial、Rewarded、Native 和 App Open 支持。
Banner 自动刷新配置 - 新增 Banner 和 MREC 对服务端禁用自动刷新配置的支持。
TaurusX 适配器可用 - TaurusX Android 适配器现已发布为 io.cloudx:adapter-taurusx:1.18.3.0，在 CloudX Android SDK 4.2.0 或更高版本中支持 Banner、MREC、Interstitial、Rewarded 和 Native 广告格式。

变更

适配器格式元数据 - 适配器现在会向 CloudX 上报支持的广告格式，帮助服务端配置将需求匹配到兼容的适配器。
Google Waterfall 报告 - 改进 Google Waterfall 响应标识和实际成交价格处理，使 waterfall 诊断和报告更准确。
渲染器可靠性 - CloudX 全屏渲染器更好地遵循设备自动旋转设置，并改进激励广告关闭与奖励资格处理。
全屏广告网络名称 - 全屏广告回调现在会使用与其他广告格式一致的原始适配器代码上报广告网络名称。
初始化容错 - 改进 SDK 在初始化和网络请求期间遇到陈旧或异常的系统 DNS 解析器状态时的恢复能力。

修复

Moloco Native Banner 展示 - 修复 Moloco Native Banner 和 Native MREC 的展示计时，确保广告视图附加到 CloudX 广告视图容器后再处理展示。
Banner 渲染计时 - 改进 Banner 和 MREC 的加载/渲染计时，将适配器渲染耗时与初始加载信号分开记录。
Google Waterfall Prefetch 可靠性 - 改进 Google Waterfall prefetch 回调处理和展示上报，避免过期的加载回调影响当前填充。
Trusted Arbiter PubMatic 比较 - 修复兜底仲裁逻辑，在将 PubMatic OpenWrap CPM 价格与单次展示收益出价比较前先进行单位规范化。

iOS SDK 3.5.0

适配器现在与 CloudXCore 独立版本化。每个适配器 pod 使用 <第三方 SDK 版本>.<适配器修订号> 格式（例如 pod 'CloudXVungleAdapter', '~> 7.7.4.0'），每次发布对应一个确切的第三方 SDK 版本。CloudXCore 继续使用 SDK 语义化版本（pod 'CloudXCore', '~> 3.5'）。

破坏性变更

适配器 pod 不再与 CloudXCore 共享版本号。 旧的统一版本线上的现有版本锁定（~> 3.4、~> 3.x）将无法解析新的适配器发布版本。请为每个适配器独立更新版本锁定，例如 pod 'CloudXMintegralAdapter', '~> 8.1.5.0'。
CloudXMagniteAdapterV2 取代 CloudXMagniteAdapter 用于独立版本化。 安装 pod 'CloudXMagniteAdapterV2', '~> 1.0.0.0' 迁移到新版本线；旧 pod 保留在旧版本线。无需修改源代码 — import 名称不变。
CloudXRenderer 不再是独立的 pod。 其功能已内置于 CloudXCore；请从 Podfile 中移除任何直接的 CloudXRenderer 依赖。

新增

Trusted Arbiter 自定义出价 — 新增 CLXArbiterBid.custom(...)、CLXArbiterPlatform.custom 和 CLXArbiterPrecision，支持与具体聚合平台无关的自定义出价输入。
App Open 广告格式 — 全新的 CLXAppOpen 广告类，用于应用启动或返回前台时展示的全屏广告。通过 createAppOpen(adUnitId:) 创建。支持 Google Waterfall、Mintegral、Pangle 和 Vungle 适配器。
CloudX 渲染器支持 VAST 视频插屏与激励视频 — CloudX 渲染器现可投放 VAST 视频插屏和激励素材，并支持 Open Measurement（OMID）视频可见性测量。发布由服务端控制；无需修改集成。
CloudX 渲染器支持 HTML 激励视频 — HTML 激励素材现可通过 CloudX 渲染器渲染，补全了 3.4.5 中为插屏引入的全屏 HTML 支持。服务端控制发布；无需修改集成。
Digital Turbine、Mintegral、Pangle、Verve 和 Google Waterfall 支持原生广告 — 这些适配器现可投放原生素材，支持独立原生和横幅位/中矩形位原生广告。
Google Waterfall — 插屏与激励视频 — CloudXGoogleWaterfallAdapter 现可投放全屏插屏和激励视素材，在横幅、中矩形、原生广告和 App Open 之外进一步扩展。
应用内 App Store 弹窗，用于安装类广告点击 — 对于声明了推广应用的 CloudX 渲染素材，点击安装类广告现在会打开应用内 App Store 产品弹窗，而不是跳转离开您的应用。
全屏 HTML 插屏点击跳转 — 由 CloudX 渲染器渲染的全屏 HTML 插屏现在支持点击跳转。
CloudXMagniteAdapterV2 1.0.0.1 — 全新的独立版本化 Magnite pod。安装：pod 'CloudXMagniteAdapterV2', '~> 1.0.0.0'。底层基于 MagniteSDK 1.0.0。

变更 — 适配器发布

Vungle CloudXVungleAdapter → ~> 7.7.4.0（VungleAds 7.7.4）。
Mintegral CloudXMintegralAdapter → ~> 8.1.5.0（MintegralAdSDK 8.1.5）。
Unity Ads CloudXUnityAdsAdapter → ~> 4.19.0.0（UnityAds 4.19.0）。
Verve CloudXVerveAdapter → ~> 3.9.0.0（HyBid 3.9.0）。
Digital Turbine CloudXDigitalTurbineAdapter → ~> 8.4.8.0（Fyber Marketplace SDK 8.4.8）。
Google Waterfall CloudXGoogleWaterfallAdapter → ~> 13.6.0.0（Google Mobile Ads SDK 13.6.0 — 从 12.x 升级的主版本更新）。
InMobi CloudXInMobiAdapter → ~> 11.3.0.0（InMobiSDK 11.3.0）。
Meta CloudXMetaAdapter → ~> 6.21.1.0（FBAudienceNetwork 6.21.1）。
Moloco CloudXMolocoAdapter → ~> 4.8.0.0（MolocoSDKiOS 4.8.0）。
Pangle CloudXPangleAdapter → ~> 7.9.1.3.0（Ads-Global 7.9.1.3）。

修复

部分竞价方未就某些横幅展示获得计费 — 横幅位原生广告的展示可能被计数但未附带竞价方计费通知，导致竞价方从未获得计费。展示现在均能正确计费。
横幅位或中矩形位原生广告可能过早上报展示 — 横幅位或中矩形位原生广告可能在广告视图实际可见前就触发展示，尤其是在离屏预加载时。展示现在会在正确的时间上报。
渲染崩溃后全屏广告卡住 — 修复了一个问题：全屏广告加载完成后，若其背后的网页内容进程崩溃，用户可能停留在无法关闭的全屏界面。广告现在会自动关闭并派发关闭回调。
紧凑布局下横幅位原生广告可能漏报展示 — 修复了一个问题：使用紧凑模板投放在横幅位的原生广告可能已显示但未登记展示。

移除

CloudXRenderer 独立 pod — 已合并至 CloudXCore。详见上方破坏性变更。

2026年7月2日

Unity

Unity SDK 4.1.7

新功能

新增按请求的底价（bid floor）覆盖 API，使发布商可以通过 SDK 竞价管道发送请求范围的底价控制

SDK 更新

将 Android SDK 从 4.1.5 更新至 4.1.7 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.4.5 更新至 3.4.6 — 详情请参阅 iOS SDK 更新日志

2026年6月29日

iOS SDK 3.4.6

变更

CloudXMolocoAdapter 现已支持完整的 MolocoSDK 4.x 系列 — MolocoSDKiOS 版本要求从 ~> 4.6.0 放宽至 >= 4.6.0, < 5.0，可采用更新的 4.x Moloco SDK 版本。这解决了可能阻碍集成的 CocoaPods 依赖冲突。

修复

广告加载完成时的罕见崩溃 — 修复了横幅或全屏（插屏/激励）广告加载完成时可能发生的罕见崩溃。受影响的广告现在能够可靠地加载并回报结果。
无填充刷新后的横幅广告重复展示计数 — 横幅自动刷新未获得出价时可能重新展示上一个创意并计入额外展示。未获得出价的刷新现在不会展示任何内容，也不会回报展示。

2026年6月26日

CloudX CLI 0.35

A/B 测试国家定向

CloudX CLI 0.35 支持直接在终端中的 A/B 测试配置编辑里为测试版本设置地域定向。

新增

A/B 测试地域定向 — 为 cloudx config edit create-ab-test 和 cloudx config edit update-ab-test 新增 --country。该标志接受重复传入或逗号分隔的 ISO 3166-1 alpha-2 或 alpha-3 国家代码，CloudX 会以 alpha-3 代码保存测试版本定向。阅读文档 →

cloudx config edit create-ab-test --ad-unit-id au_123 --name "US/GB test" --country US --country GB

2026年6月25日

Android

Android SDK 4.1.7

变更

更快的 SDK 初始化 - 通过并行向广告网络适配器下发隐私同意状态，并将非关键的启动工作移出初始化路径，降低了初始化延迟。

Android SDK 4.1.6

变更

更快的初始化 - SDK 可在已预热的会话中复用缓存的配置，降低后续启动的初始化延迟。
Trusted Arbiter 收益准确性 - 规范化仲裁中使用的兜底收益单位，使 CloudX 出价比较和收益报告更准确。

2026年6月20日

React Native
Unity

React Native SDK 3.4.6

使 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

Unity SDK 4.1.5

SDK 更新

将 Android SDK 从 4.1.3 更新至 4.1.5 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.4.2 更新至 3.4.5 — 详情请参阅 iOS SDK 更新日志
新增 Android 和 iOS 的 Pangle 适配器支持
新增 Android 的 MobileFuse 适配器支持

2026年6月19日

Android
Dashboard

Android SDK 4.1.5

新增

MobileFuse 适配器可用 - MobileFuse Android 适配器现已发布为 io.cloudx:adapter-mobilefuse:1.11.0.0，支持 Banner、MREC、Interstitial、Rewarded 和 Native 广告格式。

变更

Meta Banner 内原生路由 - Meta 原生 banner 需求现在仅在 banner 尺寸广告位中使用 Meta 的 native-banner 渲染路径；原生 MREC 广告位使用常规原生广告路径。
Vungle 原生广告支持 - 新增对 Vungle native、native banner 和 native MREC 广告格式的支持。

Dashboard — A/B 测试结果标签

A/B 测试 Dashboard 现在会更清晰地区分结果指标和百分点变化。

创建 A/B 测试时，对照组和测试组固定使用 50/50 流量拆分
累计对比指标中加入 ARPU
Fill rate 现在表示已填充的竞价响应数除以请求数
面向客户的结果标签使用 Pending、Directional 和 Achieved

阅读文档 →

2026年6月18日

Android

Android SDK 4.1.4

新增

Pangle 适配器准备就绪 - 新增独立发布的 Pangle Android 适配器所需的 SDK 侧元数据。发布商可在 CloudX Android SDK 4.1.4 或更高版本中通过 io.cloudx:adapter-pangle:8.1.0.3.0 集成 Pangle 需求。
CloudX 全屏 HTML 渲染 - 新增对 CloudX 投放的 MRAID 全屏素材在插屏和激励广告位中的 SDK 支持，并为 CloudX HTML 广告加入 OMID 可见性测量。

变更

SDK 启动性能 - 减少设备信号采集导致的 SDK 初始化和广告请求卡顿。
MRAID 全屏可靠性 - 改进 CloudX HTML 全屏广告的加载 watchdog、加载指示器、关闭按钮点击区域、mraid.unload() 支持、隐藏回调可靠性，以及激励广告提前关闭时的奖励处理。
原生广告渲染 - 改进本地文件资产的原生图片处理，并避免异步图片加载结果覆盖已复用的原生广告视图。
遥测计时准确性 - SDK 遥测耗时现在使用单调的应用运行时间计时，使诊断数据更可靠。

2026年6月16日

React Native

React Native SDK 3.4.5

使 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

2026年6月12日

iOS
React Native

iOS SDK 3.4.5

新增

InMobi、Meta、Vungle 和 Moloco 全面支持原生广告 — 本次新增 InMobi 原生与 Vungle 独立原生后，这四家需求方现已支持 CloudX 的所有原生形式：独立原生（通过 CLXNativeAdLoader）和横幅位/中矩形位原生广告。
InMobi 原生广告 — CloudXInMobiAdapter 现已支持原生广告，包括独立原生广告（通过 CLXNativeAdLoader）以及横幅/中矩形位中的原生广告。需要 InMobiSDK >= 11.2.0（适配器最低版本要求已从 11.0.0 提升）。
Vungle 独立原生广告 — CloudXVungleAdapter 现已支持通过 CLXNativeAdLoader 投放独立原生广告（横幅/中矩形位中的原生广告此前已支持）。
CloudX 渲染器支持 HTML 插屏广告 — CloudX 渲染器现已支持全屏 HTML 插屏创意（含 MRAID 3.0），与现有的 HTML 横幅/中矩形支持并列。该功能由服务端控制灰度发布，无需修改集成代码。

变更

较慢的广告网络 SDK 不再拖慢 CloudX SDK 初始化 — 较慢的网络 SDK 不再阻塞初始化；CloudX 不再等待即可完成，该网络就绪后自动加入后续竞价。尚未初始化的网络会被排除在其无法响应的竞价之外。

修复

Digital Turbine 适配器不再与其他先初始化 Fyber SDK 的聚合 SDK 冲突 — 若其他聚合 SDK 先初始化共享 Fyber SDK，CloudX 适配器现在会让步而非重新初始化。为获得平滑启动，请先初始化其他 SDK，再初始化 CloudX。
部分有效的 HTML 横幅创意被渲染器拒绝 — 修复了包含加载失败的追踪像素的 HTML 横幅/中矩形创意被误判为损坏而不展示的问题。此类创意现已能正常渲染。
Meta 与 Moloco 原生广告可靠性提升 — Meta 原生广告现在会校验加载的广告，并为所有素材视图注册展示和点击跟踪，而不仅限于 CTA。Moloco 原生广告在底层广告不可渲染时不再交付。

移除

适配器集成 API — 从适配器层面移除 clx_isFlexibleSize、+isInitialized 和按实例的 sdkVersion。这些对应用集成没有作用；标准发布商集成不受影响。

React Native SDK 3.4.4

使 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

2026年6月4日

Dashboard

Dashboard — 帮助菜单资源

Dashboard 的帮助菜单现已集中提供产品帮助、支持入口和发布更新。

打开侧边栏中的帮助后，您可以：

打开 CloudX 文档
联系支持团队
在最新动态中浏览最近的发布条目
点击某条更新，在应用内更新日志对话框中查看详情
通过更新日志跳转到完整的文档时间线

2026年6月2日

iOS SDK 3.4.4

修复

Digital Turbine 适配器在 Fyber Marketplace SDK 低于 8.4.0 时无法链接 — 适配器在 Fyber SDK 低于 8.4.0 时链接失败。现已可在整个 8.x 系列正常链接 — 横幅、中矩形、插屏和激励广告在 Fyber 8.0.0+ 可用；原生填充仍需 8.4.0+。
Google Waterfall — 中介响应较慢时偶尔丢失填充 — Google Waterfall 广告的中介瀑布流响应较慢时可能被丢弃，即使最终成功填充。响应较慢但成功的填充现已能正常交付，提升填充可靠性。

2026年6月1日

iOS
Unity

iOS SDK 3.4.3

新增

Pangle 适配器 — 全新的 CloudXPangleAdapter，支持横幅/中矩形、插屏和激励广告。安装：pod 'CloudXPangleAdapter', '~> 3.4.3'。底层基于 Pangle（字节跳动）SDK Ads-Global ~> 7.9.0。

变更

DigitalTurbine 适配器 — 更广泛的 Fyber Marketplace SDK 兼容性 — CloudXDigitalTurbineAdapter 现接受 Fyber_Marketplace_SDK >= 8.0.0（此前 >= 8.4.0）。横幅、中矩形、插屏和激励广告在整个 8.x 系列可用；原生填充仍需 Fyber SDK 8.4.0+。

修复

itms-services URL scheme 导致的 App Store 提审被拒 — 已从 SDK 二进制文件中移除该 scheme；商店跳转不受影响。
部分账户的 SDK 初始化可能失败 — 修复了没有组织标识符的账户初始化失败的问题。

Unity SDK 4.1.3

SDK 更新

将 Android SDK 从 4.1.1 更新至 4.1.3 — 详情请参阅 Android SDK 更新日志
将 iOS SDK 从 3.4.1 更新至 3.4.2 — 详情请参阅 iOS SDK 更新日志
新增 Android 和 iOS 的 Google Waterfall 和 Digital Turbine 适配器支持

2026年5月31日

Android

Android SDK 4.1.3

变更

更具弹性的适配器初始化 - 较慢的广告网络适配器不再阻塞 SDK 初始化。每个适配器有软初始化超时；超时后 SDK 完成初始化，适配器继续在后台启动。未就绪的适配器会被排除在竞价之外，直到完成初始化。

2026年5月29日

iOS SDK 3.4.2

新增

Google Waterfall 适配器 — 全新的 CloudXGoogleWaterfallAdapter（横幅、中矩形）。通过 CocoaPods（pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.2'）或 SPM 安装。基于 Google-Mobile-Ads-SDK 12.14.0；需要在 Info.plist 中配置 GADApplicationIdentifier。

CloudX CLI 0.34

扩展配置写入

CloudX CLI 0.34 将 cloudx config edit 从订单项扩展到应用、广告单元、广告单元组、列表、标签、测试设备、网络映射和 A/B 测试生命周期命令。

新增

库存草稿编辑 — 为主要库存实体新增创建、更新、删除和 upsert 命令。除特别说明外，草稿编辑会自动验证，仍需使用 cloudx config publish 发布。阅读文档 →
A/B 测试写入 — 新增 A/B 测试创建、更新、开始、结束、提升和删除命令。生命周期变更会立即发布生成的配置。阅读文档 →

CloudX API — 配置写入

公共 API 现在通过 POST /config/edit 提供带类型的配置写入操作，覆盖应用、广告单元、广告单元组、列表、标签、测试设备、网络映射、订单项和 A/B 测试。

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日

iOS
Unity

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日

Android
iOS

Android SDK 4.1.0

新增

Trusted Arbiter - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
LevelPlay 展示级收入数据 - 通过 Unity LevelPlay 集成新增展示级收入跟踪，作为现有 AppLovin ILRD 支持的补充。
广告价值访问器 - 新增 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日

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日

API
Dashboard

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日

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月12日

React Native

React Native SDK 3.2.0

本次发布将 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

2026年5月7日

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日

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日

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日

Unity
Dashboard

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 测试

不必再凭直觉判断新订单项、竞价底价或网络配置的改动是否真正带来效果。A/B 测试让您在当前配置与编辑后的变体之间分流展示量，并实时在生产环境中并排对比关键指标——收入、eCPM、填充率与展示量。

数据出炉后，一键即可上线获胜方案。打开任何启用中的广告单元，点击创建 A/B 测试，以严谨的方式优化您的变现策略。阅读文档 →

2026年4月27日

Android
MCP

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日

Android
Unity

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日

iOS SDK 3.2.0

新增

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

CloudX CLI — 在终端里使用 CloudX

CLI 控制台报表

并非每个问题都需要打开浏览器。全新的 CloudX CLI 让您的日常数据只在一行命令之间——运行 cloudx report dashboard 即可在命令行中看到收入、填充率、eCPM 与趋势。按国家、平台、广告单元或测试流量过滤，方式与控制台完全一致。

需要将数据用于下游分析时，使用 --json 输出结构化 JSON，或使用 cloudx report export 导出 CSV，直接送入电子表格、Notebook 或其他工具。通过 brew install cloudx 安装，登录一次，您的报表工作流便能随您在任何工作环境中使用。阅读文档 →

2026年4月21日

React Native

React Native SDK 3.1.2

本次主要版本升级使 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 并稍后展示，而不会提前占用父视图。

平台支持

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

2026年4月17日

Android
Unity

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 SDK 3.1.0

新增

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

修复

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

2026年4月9日

iOS SDK 2.2.9

修复

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

2026年4月6日

Android
Unity

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 SDK 2.2.8

修复

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

2026年4月2日

Android
Unity

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日

Android
iOS
Unity

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日

Android
iOS

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日

Android
iOS
React Native

Android SDK 2.2.4

新增

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

变更

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

修复

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

iOS SDK 2.2.4

变更

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

React Native SDK 2.2.3

新增

Unity Ads 适配器 — iOS 和 Android 现支持通过 Unity Ads 提供横幅、插页式和激励视频广告。
Mintegral 适配器 — Mintegral 适配器现已在 iOS 和 Android 上作为正式版本提供。

改进

全屏广告可靠性 — 修复 iOS 上显示另一个全屏广告时加载可能静默失败的问题，并修复 Android 上在隐藏或展示失败回调中重新加载广告的行为。
错误诊断 — 提升无出价场景的错误可见性，便于排查填充率问题。
减小 SDK 体积 — Android 移除 appcompat 和 webkit 传递依赖，渲染器现已包含在核心 SDK 模块中。

变更

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

平台支持

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

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
Flutter

iOS SDK 2.2.3

新增

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

修复

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

Flutter SDK 2.2.3

pub.dev 上的首个公开发布。Dart 软件包的 major.minor.patch 与其绑定的 CloudX 原生 SDK 一致（iOS CloudXCore、Android io.cloudx:sdk）。

要求

Dart SDK： >=2.17.1 <4.0.0（见 pub.dev 上的软件包 pubspec）
Flutter： >=3.0.0
iOS： 13.0+
Android： minSdk 23 (API 23)

Dart 下限刻意设低，以便仍在较旧稳定 Flutter 线上的应用可以采用 cloudx_flutter，而不必整套工具链升级。

本版本包含

横幅、MREC、插屏和激励视频广告；程序化浮层 API 以及内嵌 CloudXAdView
监听器回调、定向键值、展示级收入（onAdRevenuePaid）及相关生命周期事件
隐私辅助方法 CloudX.setHasUserConsent 和 CloudX.setDoNotSell（可空的 bool? 会清除覆盖，并在适用时回退到 CMP）
原生版本锁定：CloudXCore 2.2.3（iOS）、io.cloudx:sdk 2.2.3（Android）

宿主应用：广告网络适配器

已发布的插件仅包含核心。请只在 CocoaPods 和 Gradle 中声明您需要的广告网络适配器，版本均为 2.2.3（Meta、Vungle、InMobi、Mintegral、Unity Ads、renderer 等）。对于 Unity Ads，请添加 CloudXUnityAdsAdapter 和 io.cloudx:adapter-unityads。

Android：Mintegral

如果您依赖 io.cloudx:adapter-mintegral，必须在 Gradle 中添加 Mintegral 的 Maven 仓库 —— 制品不在 Maven Central。见 Android Mintegral 适配器 — Maven 仓库。

2026年3月17日

Android
Unity

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 SDK 2.2.2

新增

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

修复

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

变更

Mintegral SDK — 从 8.0.7 升级到 8.0.8

2026年3月11日

Android
Unity

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日

Android
Unity

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日

Android
Unity

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日

Android
iOS

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 参数 - 测试模式现在通过仪表板进行服务端控制