Documentation Index
Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
Use this file to discover all available pages before exploring further.
[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 中的可见性追踪准确性
变更
- Mintegral SDK — 从 8.0.7 升级到 8.0.8
[2.0.0] - 2026-02-04
此版本将 placement 名称替换为 CloudX 仪表板中的 Ad Unit ID。请更新您的createBannerWithAdUnitId:、createMRECWithAdUnitId:、createInterstitialWithAdUnitId: 和 createRewardedWithAdUnitId: 调用，使用 ad unit ID 而非 placement 名称。
新增
- 激励广告，使用
createRewardedWithAdUnitId:delegate:和CLXRewardedDelegate - InMobi 适配器（SDK 11.1），支持横幅、MREC、插屏和激励广告
CLXAd.networkPlacement属性用于获取网络特定的 placement ID
重大变更
- 在
createBannerWithAdUnitId:、createMRECWithAdUnitId:、createInterstitialWithAdUnitId:、createRewardedWithAdUnitId:中将placement参数重命名为adUnitId - 将
CLXAd.placement重命名为adUnitId - 将
CLXAd.bidderName重命名为networkName - 将
CLXErrorCodeInvalidPlacement重命名为CLXErrorCodeInvalidAdUnit - 更改
bannerAdView:didFailWithError:以在错误中包含 ad unit ID - 从
initializeSDKWithAppKey:completion:中移除testMode参数 - 测试模式现在通过仪表板进行服务端控制
变更
- Meta Audience Network SDK 从 6.17.0 更新到 6.21.0
- Vungle SDK 从 7.4.2 更新到 7.6.0
修复
- 修复 IFA（广告标识符）收集问题
- 修复国家/地理定向数据收集问题
[1.3.0] - 2025-12-14
新增
- 横幅刷新重试 - 横幅广告现在在隐藏后会自动重试加载失败的广告
修复
- App Extension 兼容性 - SDK 现在可以在 App Extensions 中正常工作（无 UIApplication 调用）
- 激励广告代理回调 - 修复回调顺序错误
- 符号冲突 - 所有分类方法现在都以
clx_为前缀以防止冲突
变更
- CloudXCore 现在以动态框架分发 - 支持 SDK 问题的崩溃符号化
[1.2.1] - 2025-12-04
新增
- 可视化调试器按钮 - 用于开发和 QA 的新调试工具
- 高 ROI 键值定向示例 - 增强的演示应用，包含定向信号示例
修复
- 更正 podspecs 中的 vendored_frameworks 路径