概览AndroidiOSUnityReact NativeFlutterCLIAPIMCP需求广告格式Dashboard更新日志

更新日志

Unity SDK 发布历史

[4.9.0] - 2026-10-07

新增

  • CloudXSdk.ShowMediationDebugger() 可打开聚合调试器，这是一个应用内界面，列出每个已安装适配器及其版本和状态、您的广告单元以及 SDK 配置。初始化完成前调用会返回 false。面向开发和 QA 构建。

集成说明

  • 横幅或 MREC 广告在加载成功后再失败时，现在会回调 OnAdLoadFailed。在自动刷新已停止的情况下，SDK 不会自行补位；请调用 Load() 请求新广告。

SDK 更新

  • Android SDK 从 4.8.2 更新到 4.9.0 — 详见 Android SDK 更新日志
  • Android InMobi 适配器从 11.4.1.0 更新到 11.5.0.0。
  • Android Moloco 适配器从 4.12.0.0 更新到 4.13.0.0。
  • Android Unity Ads 适配器从 4.20.1.0 更新到 4.21.0.0。
  • Android Vungle 适配器从 7.7.8.0 更新到 7.7.9.0。
  • iOS Mintegral 适配器从 8.1.6.0 更新到 8.1.6.1。
  • iOS Moloco 适配器从 4.10.0.0 更新到 4.11.0.0。

[4.8.2] - 2026-09-30

SDK 更新

  • Android SDK 版本从 4.8.0 更新至 4.8.2 — 详见 Android SDK 更新日志
  • 将 iOS SDK 从 3.9.1 更新至 3.10.0 — 详情请参阅 iOS SDK 更新日志
  • Android Google Waterfall 适配器版本从 25.4.0.0 更新至 25.5.0.0。该版本要求 Android API 24 或更高版本。
  • Android AdMob 适配器版本从 1.4.0.0 更新至 1.5.0.0。
  • Android TaurusX 适配器版本从 1.18.3.0 更新至 1.19.1.0。
  • 在 CloudXDependencies.xml 的可选适配器行中新增 iOS BIGO Ads 适配器 6.1.0.0。

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

[4.8.1] - 2026-09-23

新增

  • CloudXAd.MediatorName 和 CloudXAd.MediatorAdUnitId 会报告投放该广告的中介及其广告单元。CloudX 竞得的广告返回 cloudx 及其 CloudX 广告单元 ID。仅 Android 提供；在 iOS 上为 null。
  • CloudXSdkConfiguration.AdUnitConfigurations 在初始化完成后，将每个广告单元 ID 映射到其 IsOrchestratorEnabled 状态。条目缺失表示不可用，而非已禁用。仅 Android 提供；在 iOS 上为空。
  • Unity 插件现在会为 iOS 构建提供隐私清单，因此集成 CloudX 的应用可以向 App Store 审核声明其 Required Reason API 的使用情况。

SDK 更新

  • Android AdMob 适配器版本从 1.3.0.4 更新至 1.4.0.0。
  • Android SDK 仍为 4.8.0。

[4.8.0] - 2026-09-22

修复

  • Android 竖版横幅广告现在会保持在应用窗口的可见区域内，因此在会将窗口裁剪至该区域的设备上不会再消失。

SDK 更新

  • Android SDK 版本从 4.7.0 更新至 4.8.0 — 详见 Android SDK 更新日志
  • Android BIGO Ads 适配器版本从 6.0.1.0 更新至 6.1.0.0。
  • Android InMobi 适配器版本从 11.4.0.1 更新至 11.4.1.0。
  • Android Mintegral 适配器版本从 17.1.71.1 更新至 17.1.81.0。
  • Android Pangle 适配器版本从 8.3.0.3.0 更新至 8.3.0.4.0。
  • Android Verve 适配器版本从 3.9.0.1 更新至 3.9.2.0。
  • Android Vungle 适配器版本从 7.7.7.0 更新至 7.7.8.0。

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

[4.7.2] - 2026-09-16

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。

[4.7.1] - 2026-09-15

修复

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

[4.7.0] - 2026-09-11

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。

[4.6.1] - 2026-09-01

新功能

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

修复

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

SDK 更新

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

[4.6.0] - 2026-08-26

修复

  • 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 适配器版本。

[4.5.1] - 2026-08-18

新功能

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

[4.5.0] - 2026-08-11

新功能

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

[4.4.1] - 2026-08-03

新功能

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

[4.4.0] - 2026-07-29

新功能

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

[4.1.7] - 2026-07-02

新功能

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

SDK 更新

[4.1.5] - 2026-06-20

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 适配器支持

[4.1.3] - 2026-06-01

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 适配器支持

[4.1.0] - 2026-05-27

新功能

  • 新增 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 适配器支持

[4.0.0] - 2026-04-28

新功能

  • 新增 Unity Package Manager（UPM）消费支持，使 SDK 可在内部 UPM 包中被引用。运行时和编辑器脚本现在通过程序集定义文件（CloudX.Sdk 与 CloudX.Sdk.Editor）发布。
  • 移除对 Newtonsoft.Json 的运行时依赖。SDK 不再要求项目中存在 com.unity.nuget.newtonsoft-json。

SDK 更新

[3.2.0] - 2026-04-24

新功能

  • Unity API 新增 DestroyInterstitial(adUnitId) 和 DestroyRewarded(adUnitId)，可显式销毁并清理全屏广告实例

SDK 更新

[3.1.0] - 2026-04-17

新功能

  • 收益回调现在会在 Android 和 iOS 上立即触发，并且可能不在 Unity 主线程上执行

集成说明

  • 不要在 OnAdRevenuePaid 中直接操作 Unity 场景或 UI API。如有需要，请先切回主线程。

SDK 更新

[3.0.0] - 2026-04-06

SDK 更新

[2.2.7] - 2026-04-02

新功能

  • 通过更新后的 Android SDK，新增一方指标遥测在更多 SDK 调用链路中的覆盖
  • 通过更新后的 iOS SDK，修复 Banner 在延迟初始化后无法显示的问题，并提升 Vungle 适配器的运行时稳定性

集成说明

  • 2.2.6 引入的 Unity 集成流程以及 Banner / MREC 的 placement 与 customData 调用顺序在本次发布中保持不变

SDK 更新

[2.2.6] - 2026-04-01

新功能

  • 通过更新后的 Android 和 iOS SDK，为全屏广告适配器新增 isAdReady 支持
  • 通过更新后的 iOS SDK，新增 Unity Ads 隐私同意转发支持

集成说明

  • 对于 Unity Banner 和 MREC 广告，如果希望首次请求就带上 placement 和 customData，请在调用 CreateBanner(...) 或 CreateMrec(...) 之前先调用 SetBannerPlacement(...) / SetBannerCustomData(...) 和 SetMrecPlacement(...) / SetMrecCustomData(...)

SDK 更新

[2.2.4] - 2026-03-27

新功能

  • 新增 SetHasUserConsent(bool?) 和 SetDoNotSell(bool?)，可在初始化前手动设置隐私覆盖值
  • 新增 iOS 后处理逻辑：当应用尚未定义 NSUserTrackingUsageDescription 时，会自动写入该字段

修复

  • 修复 Android Banner 视图初始化行为：新创建的 Banner 视图默认保持隐藏，直到您调用显示
  • 修复 iOS 插屏和激励广告的展示失败回调，OnAdShowFailed 现在会同时返回失败的 CloudXAd 和对应的 CloudXError，与 Unity 回调约定保持一致
  • 更新 Unity Demo：Banner 和 MREC 仅初始化一次，并在全屏广告加载失败或展示失败后自动重试

SDK 更新

[2.2.3] - 2026-03-23

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 适配器支持

[2.2.2] - 2026-03-17

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）

[2.2.1] - 2026-03-11

SDK 更新

  • 将 Android SDK 从 2.2.0 更新至 2.2.1 — 详情请参阅 Android SDK 更新日志
  • 新增 Mintegral 适配器及 Maven 仓库（Android）

[2.2.0] - 2026-03-10

SDK 更新

[2.0.1] - 2026-03-04

此补丁版本增加了对 Unity Engine 2022.3 的完整兼容性。

兼容性

  • 新增对 Unity Engine 2022.3 LTS 的支持

SDK 更新

[2.0.0] - 2026-02-05

重大变更

  • 横幅广告和 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

[0.12.1] - 2026-01-15

新功能

  • 新增对 iOS 平台的支持

性能改进

  • Android：BidToken 现在在后台线程生成，提升了性能

SDK 更新

  • 将 Android SDK 从 0.12.0 更新至 0.12.1

改进

  • 重命名内部 UnityMainThreadDispatcher 类，避免与第三方包命名空间冲突

[0.12.0] - 2025-12-15

CloudX Unity SDK 初始发布