更新日志

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.

​

[4.1.0] - 2026-05-22

​

新增

• Trusted Arbiter - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
• 广告价值访问器 - 新增 CloudXAd.adValues，用于读取 SDK 提供的广告元数据；新增 CloudXAd.realizedRevenueUsd，用于在广告网络支持时读取展示时收入。
• 扩展广告网络支持 - 新增 Google Waterfall、Moloco 和 Verve 适配器的 SDK 支持。适配器制品仍会独立发布。
• MRAID 3.0 广告视图渲染 - CloudX 渲染器新增对 MRAID 3.0 banner 和 MREC 素材的支持。

​

[4.0.0] - 2026-04-27

​

破坏性变更

• 适配器版本兼容性 - 适配器现在会声明其最低兼容 CloudX SDK 版本。SDK 会在初始化期间跳过不兼容的适配器。

​

新增

• 独立适配器版本 - CloudX 适配器现在独立于核心 SDK 发布，兼容的适配器更新可以按自己的发布节奏交付。

​

变更

• 发布商 Release 构建 - 改进了 release 构建兼容性，确保 SDK 初始化和适配器加载所需的 CloudX 运行时类会被保留。

​

修复

• Release 构建初始化 - 修复了一个可能导致经过混淆压缩的发布商构建无法初始化 SDK 的问题。

​

[3.2.0] - 2026-04-24

​

新增

• Magnite 适配器 - 新增 Magnite 适配器，支持 banner、interstitial 和 rewarded 广告。
• 按请求覆盖竞价底价 - 新增按请求覆盖竞价底价的 API，使发布商能够通过 SDK 竞价链路传递请求级底价控制。

​

变更

• 改进了各适配器的 banner 和 MREC 生命周期处理，使渲染、刷新和清理行为更加一致。

​

修复

• 当可选适配器或广告网络 SDK 依赖在运行时缺失时，SDK 的容错能力得到提升。
• 修复 Vungle banner 加载错误，使无效的 banner 加载状态会通过 SDK 错误回调明确返回。

​

[3.1.0] - 2026-04-17

​

新增

• 原生广告 - 新增原生广告支持，包括 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 依赖和适配器加载失败时的容错能力。

​

[3.0.0] - 2026-04-06

​

破坏性变更

• CloudX.initialize() 现在需要 Android Context，公共广告创建 API 也需要 Context：createBanner()、createMREC()、createInterstitial() 和 createRewarded()。

​

变更

• 移除了进程启动时的自动初始化；应用现在通过 SDK 初始化和广告创建 API 显式提供 Context。
• 减少调用 CloudX.initialize() 之前的 SDK 工作量，降低主线程启动开销和 ANR 风险。

​

[2.2.7] - 2026-04-02

​

修复

• 降低应用在调用 CloudX.initialize() 之前已引入 SDK 时的启动 ANR 风险。

​

[2.2.6] - 2026-04-01

​

变更

• 改进 SDK 和广告网络适配器事件中的广告生命周期、收入和崩溃报告可靠性。
• 改进 banner、interstitial 和 rewarded 事件归因，使 placement 和 custom data 能够被一致跟踪。

​

修复

• 改进竞价响应解析、适配器初始化和广告加载失败路径的错误报告。

​

[2.2.5] - 2026-03-30

​

新增

• 新增 CloudXErrorCode.LOAD_NOT_ALLOWED_WHILE_SHOWING，用于同一个全屏广告实例正在展示时调用 load() 的场景。
• 新增 interstitial 和 rewarded 适配器的全屏广告就绪状态检查。

​

变更

• 改进全屏广告就绪状态处理，已过期或已失效的广告网络广告不会再被报告为可展示。
• 改进全屏广告复用行为，避免展示陈旧缓存广告。

​

修复

• 修复全屏广告正在展示时仍接受 load() 的问题；现在会立即通过 onAdLoadFailed(..., LOAD_NOT_ALLOWED_WHILE_SHOWING) 失败。
• 修复底层广告网络 SDK 已使广告对象失效或过期后，全屏广告仍被报告为可展示的问题。
• 修复由 CMP 管理的集成中 Mintegral GDPR 同意状态传递问题。

​

[2.2.4] - 2026-03-26

​

新增

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

​

变更

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

​

修复

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

​

[2.2.3] - 2026-03-20

​

新增

• 新增服务端控制的诊断日志收集，用于集成支持。

​

变更

• 将 Unity 适配器制品重命名为 adapter-unityads，并统一 SDK 设置和文档中的 Unity Ads 命名。

​

修复

• 修复 Unity Ads 网络名称大小写，使其与服务端竞价方配置匹配。

​

[2.2.2] - 2026-03-17

​

新增

• 通过上报适配器元数据改进 SDK 初始化诊断能力。

​

修复

• 修复 InMobi 竞价令牌获取，确保令牌收集在主线程上运行。

​

[2.2.1] - 2026-03-11

​

变更

• 加固 Mintegral 适配器，改进其在受支持广告格式中的空值和广告加载异常处理。
• 将 Mintegral SDK 从 17.0.61 升级到 17.0.91。

​

修复

• 修复适配器竞价扩展收集逻辑，避免某个适配器抛出异常时阻止后续适配器的扩展被包含。

​

[2.2.0] - 2026-03-10

​

新增

• 展示级收入数据 - 通过 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 的问题。
• 改进临时网络和服务端错误的重试分类。

​

[2.0.1] - 2026-03-04

​

变更

• 通过移除 SDK 事件持久化中的数据库运行时依赖，改进 Unity 2022.3 兼容性。
• 将 Meta Audience Network SDK 从 6.21.0 降级到 6.20.0，以避免 Unity 2022.3 构建兼容性问题。

​

修复

• 修复展示跟踪期间可能出现的并发问题。
• 修复使用 singleTask 启动模式的应用中的 Meta rewarded 广告处理。

​

[2.0.0] - 2026-02-04

此版本将 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 线程上投递。

​

[0.12.1] - 2025-12-23

​

修复

• 修复 Meta 适配器在主线程收集竞价令牌导致的 ANR 风险。

​

[0.12.0] - 2025-12-14

​

破坏性变更

• 移除 CloudXError.effectiveMessage；请直接使用 message。
• 移除 setLoggingEnabled()；请使用 setMinLogLevel(CloudXLogLevel.NONE) 禁用日志。
• 移除 CloudXPrivacy；隐私现在通过标准隐私信号自动处理。

​

变更

• 通过 GPP Section 2 解析和供应商同意检查增强 GDPR 支持。
• 简化 TCF purpose 检查，现在只需要 purpose 1 和 2。
• 新增通过 GPP 支持 CCPA，并保留旧版 US Privacy 回退。
• 移除 COPPA 处理。
• 新增 CloudXLogLevel.NONE，用于禁用日志。

​

修复

• 修复初始化期间的 geo API 失败处理。

​

[0.11.1] - 2025-12-23

​

修复

• 修复 Meta 适配器在主线程收集竞价令牌导致的 ANR 风险。

​

[0.11.0] - 2025-12-09

​

变更

• 将 SDK HTTP 客户端从 Ktor 3.0.3 迁移到 OkHttp 4.12.0。
• 为所有广告格式新增已销毁状态保护。

​

[0.10.0] - 2025-12-03

​

新增

• Vungle 适配器 - 新增 Vungle 适配器，支持 banner 和 interstitial 广告。

​

变更

• 将日志标签简化为 CloudX，便于 logcat 过滤。
• 为公共 API 入口新增日志，便于集成调试。
• 当找不到适配器时，SDK 初始化现在会尽早失败并返回清晰错误。

​

修复

• 修复 banner 加载失败后刷新停止的问题。

​

[0.9.0] - 2025-11-26

​

新增

• 通过 CloudXAdRevenueListener.onAdRevenuePaid() 新增广告收入跟踪。

​

变更

• 将 Ktor 从 2.3.8 升级到 3.0.3，提升与使用 Ktor 3.x 的应用的兼容性。

​

修复

• 修复广告生命周期管理中的内存泄漏。
• 改进 SDK 稳定性。

​

[0.6.0] - 2025-11-03

​

新增

• 为 CloudXInitializationParams 新增 testMode 支持，用于开发期间请求测试广告。

​

[0.4.0] - 2025-10-27

​

新增

• CloudX Android SDK 初始 alpha 版本。
• 新增 banner 和 MREC 广告支持。
• 新增 interstitial 广告支持。
• 新增通过 CloudX mediation 的实时竞价。
• 新增 CloudX 和 Meta Audience Network 适配器支持。
• 新增 GDPR、CCPA、US Privacy、TCF 和 GPP 信号的隐私合规支持。
• 新增用于竞价优化的会话深度跟踪。
• 新增广告生命周期回调和错误处理。
• 新增可配置日志级别的调试日志。