更新日志

iOS SDK 发布历史

Moloco 适配器 4.11.1.0 - 2026-10-08

变更

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

Mintegral 适配器 8.1.6.1 - 2026-10-06

Fixed

修正 Mintegral 适配器框架的 Bundle 版本号，避免 App Store 验证错误。MintegralAdSDK 仍为 8.1.6。安装：pod 'CloudXMintegralAdapter', '~> 8.1.6.1'。
已包含隐私清单 — 适配器框架现已包含其 Apple 隐私清单。

[3.10.0] - 2026-09-24

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

新增

聚合调试器（Mediation Debugger） — 初始化完成后调用 +[CloudXCore showMediationDebugger]，即可查看每个适配器的状态、隐私信号和广告单元，为任意广告单元加载测试广告，并为下次启动申请测试模式。在 CLXSDKInitializedNotification 发出之前调用会返回 NO。
全屏视频支持 App Store 展示方式 — CloudX 渲染的视频广告可在用户跳过或关闭时打开应用内 App Store 页面，或在播放期间显示 Apple 的 App Store 浮层。用户始终停留在您的应用内。
多张结束卡片 — CloudX 渲染的全屏视频广告可依次展示多张结束卡片。关闭一张卡片会先进入下一张，最后才关闭广告。

变更

CloudX 渲染的全屏视频广告的点击现在在您的应用内打开 App Store，不再跳出应用。点击回调仅在用户真实点击时触发。
广告遵循广告主设定的过期时间 — 展示已过期的全屏广告会以 CLXErrorCodeAdapterAdExpired（616）失败；请在展示前检查 isReady。已展示过的原生广告不再收到过期回调。
收入回调现在会在测试模式下触发 — 此前在测试设备上不会触发，现在会触发，便于您验证收入回调的接入。测试模式下的回调中 revenue 为 0、revenuePrecision 为 "undefined"。
CLXAd.revenue 报告实际展示收入 — 当投放广告的网络提供该数据时使用实际值，并附带相应的 revenuePrecision。否则报告竞价预估值，精度为 "estimated"。
CloudXCore 隐私清单已更新 — 现已声明文件时间戳 API 的使用和崩溃数据的收集。

修复

重复调用初始化不再启动两次初始化。 第二次调用会等待第一次尝试完成。
CloudX 渲染的广告无法再在用户未点击的情况下打开广告主页面或上报点击。
内置原生广告模板在广告未提供相应素材时，不再显示空白的媒体区域或空白按钮。
启用广告缓存后，展示前被销毁的原生广告在有效期内会被下一次加载复用。
提升了此前在同一会话中拒绝首个请求之后所有请求的需求方的填充率。

BIGO Ads 适配器 6.1.0.0 - 2026-09-23

变更

已通过 BigoADS 6.1.0 认证 — CloudXCore >= 3.9.0 与 iOS 13.0 要求保持不变。安装：pod 'CloudXBigoAdapter', '~> 6.1.0.0'。

BIGO Ads 适配器 5.3.0.0 - 2026-09-17

新增

首个公开 BIGO Ads 适配器版本 — 使用 BigoADS 5.3.0，支持横幅、中矩形、插屏和激励广告。要求 CloudXCore >= 3.9.0。安装：pod 'CloudXBigoAdapter', '~> 5.3.0.0'。

Unity Ads 适配器 4.20.1.0 - 2026-09-15

变更

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

Unity Ads 适配器 4.20.0.0 - 2026-09-15

变更

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

Google Waterfall 适配器 13.9.0.0 - 2026-09-14

变更

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

Google Waterfall 适配器 13.8.0.0 - 2026-09-14

变更

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

Google Waterfall 适配器 13.7.0.0 - 2026-09-14

变更

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

修复

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

[3.9.1] - 2026-09-14

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

变更

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

修复

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

Digital Turbine 适配器 8.4.10.0 - 2026-09-14

变更

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

Moloco 适配器 4.10.0.0 - 2026-09-14

变更

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

Moloco 适配器 4.9.1.0 - 2026-09-14

变更

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

Moloco 适配器 4.9.0.0 - 2026-09-14

变更

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

Moloco 适配器 4.8.1.0 - 2026-09-14

变更

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

Pangle 适配器 8.3.0.6.0 - 2026-09-14

变更

已通过 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'。

Pangle 适配器 8.2.1.0.0 - 2026-09-14

变更

已通过 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'。

Pangle 适配器 8.2.0.9.0 - 2026-09-14

变更

已通过 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'。

Pangle 适配器 8.2.0.8.0 - 2026-09-14

变更

已通过 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'。

[3.9.0] - 2026-09-10

安装：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 前就被丢弃。

Unity Ads 适配器 4.17.0.0 - 2026-09-11

新增

面向 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。

Vungle 适配器 7.7.1.0 - 2026-09-11

新增

面向 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。

Vungle 适配器 7.7.6.0 - 2026-09-08

变更

已通过 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'。

Mintegral 适配器 8.1.6.0 - 2026-09-08

变更

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

Pangle 适配器 8.1.0.6.0 - 2026-09-07

新增

面向 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。

Pangle 适配器 8.1.0.7.0 - 2026-09-07

新增

面向 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。

Moloco 适配器 4.7.0.0 - 2026-09-05

新增

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

Google Waterfall 适配器 12.12.0.0 - 2026-09-02

新增

面向 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。

TaurusX 适配器 1.18.2.0 - 2026-08-28

变更

已通过 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'。

Mintegral 适配器 8.1.3.0 - 2026-08-28

新增

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

[3.8.0] - 2026-08-24

安装：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 会被静默丢弃。
并发网络响应处理更快 — 网络请求完成回调不再逐一串行处理，单个缓慢的响应不会再拖延初始化和竞价期间其他已完成的请求。

MobileFuse 适配器 1.11.0.1 - 2026-08-24

修复

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

Google Waterfall 适配器 12.14.0.3 - 2026-08-26

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。

Google Waterfall 适配器 13.6.0.4 - 2026-08-26

变更

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'。

Meta 适配器 6.20.1.0 - 2026-08-28

变更

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

Vungle 适配器 7.6.3.0 - 2026-08-28

变更

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

Unity Ads 适配器 4.16.3.0 - 2026-08-28

变更

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

Mintegral 适配器 8.0.3.0 - 2026-08-28

变更

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

Google Waterfall 适配器 13.6.0.3 - 2026-08-21

变更

全屏广告通过 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'。

InMobi 适配器 11.4.1.0 - 2026-08-18

变更

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

Meta 适配器 6.22.0.0 - 2026-08-12

变更

要求 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 投放；除更新适配器外无需更改集成代码。

[3.7.0] - 2026-08-11

安装：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 级别记录，错误日志与崩溃监控告警只反映真实故障。

Google Waterfall 适配器 13.6.0.2 - 2026-08-11

新增

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

变更

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

Google Waterfall 适配器 12.14.0.2 - 2026-08-11

新增

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。

TaurusX 适配器 1.18.1.0 - 2026-08-03

新增

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

Pangle 适配器 8.2.0.7.0 - 2026-07-30

变更

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

Google Waterfall 适配器 12.14.0.1 - 2026-07-29

修复

预取的 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。

[3.6.0] - 2026-07-28

安装：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(_:) 及公开的收入类型上报收入。

Google Waterfall 适配器 13.6.0.1 - 2026-07-21

修复

预取的 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。

MobileFuse 适配器 1.11.0.0 - 2026-07-08

新增

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

[3.5.0] - 2026-07-07

适配器现在与 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。详见上方破坏性变更。

[3.4.6] - 2026-06-29

变更

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

修复

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

[3.4.5] - 2026-06-12

新增

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。这些对应用集成没有作用；标准发布商集成不受影响。

[3.4.4] - 2026-06-02

修复

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 广告的中介瀑布流响应较慢时可能被丢弃，即使最终成功填充。响应较慢但成功的填充现已能正常交付，提升填充可靠性。

[3.4.3] - 2026-06-01

新增

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 初始化可能失败 — 修复了没有组织标识符的账户初始化失败的问题。

[3.4.2] - 2026-05-29

新增

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

[3.4.1] - 2026-05-27

新增

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

修复

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

[3.4.0] - 2026-05-22

新增

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 调用以内联方式触发。运行时行为无变化。

修复

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

[3.2.0] - 2026-04-22

新增

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

[3.1.0] - 2026-04-16

新增

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

修复

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

[2.2.9] - 2026-04-09

修复

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

[2.2.8] - 2026-04-03

修复

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

[2.2.7] - 2026-04-01

修复

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

[2.2.6] - 2026-03-30

新增

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

修复

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

[2.2.4] - 2026-03-26

变更

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

[2.2.3] - 2026-03-19

新增

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

修复

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

[2.2.2] - 2026-03-16

新增

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

修复

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

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