> ## 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.

# 更新日志

> Android SDK 发布历史

## \[4.2.0] - 2026-07-07

### 新增

* **App Open 广告** - 新增通过 `CloudX.createAppOpen()` 和 `CloudXAdFormat.APP_OPEN` 使用 App Open 广告的支持，适用于应用回到前台等广告场景。
* **发布商收益上报** - 新增 `CloudX.reportRevenueData()` 和 `CloudXRevenueData`，发布商可将 AdMob 展示级收入事件转发到 CloudX 报告链路。
* **Trusted Arbiter 自定义出价** - 新增 `CloudXArbiterBid.custom()`、`CloudXArbiterPlatform.CUSTOM` 和 `CloudXArbiterPrecision`，支持与具体中介平台无关的自定义出价输入。
* **扩展 Google Waterfall 支持** - 新增 Google Waterfall Interstitial、Rewarded、Native 和 App Open 支持。
* **Banner 自动刷新配置** - 新增 Banner 和 MREC 对服务端禁用自动刷新配置的支持。
* **TaurusX 适配器可用** - TaurusX Android 适配器现已发布为 `io.cloudx:adapter-taurusx:1.18.3.0`，在 CloudX Android SDK 4.2.0 或更高版本中支持 Banner、MREC、Interstitial、Rewarded 和 Native 广告格式。

### 变更

* **适配器格式元数据** - 适配器现在会向 CloudX 上报支持的广告格式，帮助服务端配置将需求匹配到兼容的适配器。
* **Google Waterfall 报告** - 改进 Google Waterfall 响应标识和实际成交价格处理，使 waterfall 诊断和报告更准确。
* **渲染器可靠性** - CloudX 全屏渲染器更好地遵循设备自动旋转设置，并改进激励广告关闭与奖励资格处理。
* **全屏广告网络名称** - 全屏广告回调现在会使用与其他广告格式一致的原始适配器代码上报广告网络名称。
* **初始化容错** - 改进 SDK 在初始化和网络请求期间遇到陈旧或异常的系统 DNS 解析器状态时的恢复能力。

### 修复

* **Moloco Native Banner 展示** - 修复 Moloco Native Banner 和 Native MREC 的展示计时，确保广告视图附加到 CloudX 广告视图容器后再处理展示。
* **Banner 渲染计时** - 改进 Banner 和 MREC 的加载/渲染计时，将适配器渲染耗时与初始加载信号分开记录。
* **Google Waterfall Prefetch 可靠性** - 改进 Google Waterfall prefetch 回调处理和展示上报，避免过期的加载回调影响当前填充。
* **Trusted Arbiter PubMatic 比较** - 修复兜底仲裁逻辑，在将 PubMatic OpenWrap CPM 价格与单次展示收益出价比较前先进行单位规范化。

## \[4.1.7] - 2026-06-25

### 变更

* **更快的 SDK 初始化** - 通过并行向广告网络适配器下发隐私同意状态，并将非关键的启动工作移出初始化路径，降低了初始化延迟。

## \[4.1.6] - 2026-06-25

### 变更

* **更快的初始化** - SDK 可在已预热的会话中复用缓存的配置，降低后续启动的初始化延迟。
* **Trusted Arbiter 收益准确性** - 规范化仲裁中使用的兜底收益单位，使 CloudX 出价比较和收益报告更准确。

## \[4.1.5] - 2026-06-19

### 新增

* **MobileFuse 适配器可用** - MobileFuse Android 适配器现已发布为 `io.cloudx:adapter-mobilefuse:1.11.0.0`，支持 Banner、MREC、Interstitial、Rewarded 和 Native 广告格式。

### 变更

* **Meta Banner 内原生路由** - Meta 原生 banner 需求现在仅在 banner 尺寸广告位中使用 Meta 的 native-banner 渲染路径；原生 MREC 广告位使用常规原生广告路径。
* **Vungle 原生广告支持** - 新增对 Vungle native、native banner 和 native MREC 广告格式的支持。

## \[4.1.4] - 2026-06-18

### 新增

* **Pangle 适配器准备就绪** - 新增独立发布的 Pangle Android 适配器所需的 SDK 侧元数据。发布商可在 CloudX Android SDK 4.1.4 或更高版本中通过 `io.cloudx:adapter-pangle:8.1.0.3.0` 集成 Pangle 需求。
* **CloudX 全屏 HTML 渲染** - 新增对 CloudX 投放的 MRAID 全屏素材在插屏和激励广告位中的 SDK 支持，并为 CloudX HTML 广告加入 OMID 可见性测量。

### 变更

* **SDK 启动性能** - 减少设备信号采集导致的 SDK 初始化和广告请求卡顿。
* **MRAID 全屏可靠性** - 改进 CloudX HTML 全屏广告的加载 watchdog、加载指示器、关闭按钮点击区域、`mraid.unload()` 支持、隐藏回调可靠性，以及激励广告提前关闭时的奖励处理。
* **原生广告渲染** - 改进本地文件资产的原生图片处理，并避免异步图片加载结果覆盖已复用的原生广告视图。
* **遥测计时准确性** - SDK 遥测耗时现在使用单调的应用运行时间计时，使诊断数据更可靠。

## \[4.1.3] - 2026-05-31

### 变更

* **更具弹性的适配器初始化** - 初始化较慢的广告网络适配器不再阻塞 SDK 初始化。每个适配器都有一个软初始化超时，超时后 SDK 会完成初始化，而该适配器继续在后台启动。尚未就绪的适配器会被暂时排除在竞价之外，直到其完成初始化，从而避免可能无法填充的过早出价。

## \[4.1.2] - 2026-05-28

### 新增

* **Banner 内原生渲染** - 支持的适配器（包括 Meta、Moloco 和 Vungle）的原生广告需求现在可以通过现有的 banner 公共 API 投放到标准 banner 和 MREC 广告位中。

### 变更

* **服务端驱动的"始终奖励"模式** - 激励广告适配器现在支持在 Dashboard 中按 line item 配置的 `shouldAlwaysRewardUser` 标志。当启用时，即使部分广告网络不一定回传奖励信号，SDK 也会触发奖励回调。发布商无需修改集成代码即可受益。

## \[4.1.1] - 2026-05-26

### 新增

* **Digital Turbine 适配器支持** - 新增对 Digital Turbine Android 适配器的 SDK 支持。适配器制品仍会独立发布。
* **扩展广告网络映射** - 新增 BidMachine、Chartboost、Digital Turbine、LoopMe、MobileFuse、Pangle、PubMatic 和 Yandex 的 SDK 广告网络映射，使兼容适配器在可用后能够独立发布。

### 变更

* **Digital Turbine 适配器元数据** - 更新 Digital Turbine 适配器元数据和错误报告兼容性，以配合 CloudX SDK 4.1.1。
* **Google Waterfall 适配器** - 将 Google Waterfall 支持更新至 Google Mobile Ads SDK 25.1.0，并在 AdMob 展示级收入回调不可用时为 banner/MREC 新增备用展示上报。

## \[4.1.0] - 2026-05-22

### 新增

* **Trusted Arbiter** - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
* **LevelPlay 展示级收入数据** - 通过 Unity LevelPlay 集成新增展示级收入跟踪，作为现有 AppLovin ILRD 支持的补充。
* **广告价值访问器** - 新增 `CloudXAd.adValues`，用于读取 SDK 提供的广告元数据。
* **扩展广告网络支持** - 新增 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` 或更高版本：
  ```kotlin theme={null}
  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 信号的隐私合规支持。
* 新增用于竞价优化的会话深度跟踪。
* 新增广告生命周期回调和错误处理。
* 新增可配置日志级别的调试日志。