跳转到主要内容
格式基于 Keep a Changelog, 本项目遵循 语义化版本

[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 路径

[1.2.0] - 2025-11-26

🚀 首次正式发布

CloudX iOS SDK 的初始版本,支持横幅、MREC 和插屏广告。