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

# 更新日志

> CloudX 综合发布说明

<Update label="2026年7月30日" tags={["iOS","Dashboard"]}>
  ### iOS SDK — Pangle 适配器 8.2.0.7.0

  #### 变更

  * **Pangle** `CloudXPangleAdapter` → `~> 8.2.0.7.0`（Ads-Global 8.2.0.7）。安装：`pod 'CloudXPangleAdapter', '~> 8.2.0.7.0'`；需要 `CloudXCore >= 3.5.0`。

  ### Dashboard — 总收入仪表板

  <img src="https://mintcdn.com/cloudx-928dcb24/pTlS4959ibu5qnrB/images/total-revenue-changelog.png?fit=max&auto=format&n=pTlS4959ibu5qnrB&q=85&s=0224ed77d40a225f9486cc8b3a3cf8dc" alt="总收入仪表板。" width="2684" height="1062" data-path="images/total-revenue-changelog.png" />

  **总收入**将 CloudX 与已连接聚合平台的效果汇总到同一个仪表板中，让您可以在一处比较整体广告变现结果。[阅读文档 →](/zh/dashboard/total-revenue)
</Update>

<Update label="2026年7月29日" tags={["iOS","React Native","Unity"]}>
  ### iOS SDK — Google Waterfall 适配器 12.14.0.1

  #### 修复

  * **预取的 Google 广告可能在过期后仍被展示（12.14.0）** — 13.6.0.1 修复的回移，面向 Google Mobile Ads SDK 12.14.0；填充现在会在过期前刷新，防止空白渲染。安装：`pod 'CloudXGoogleWaterfallAdapter', '12.14.0.1'`；需要 `CloudXCore >= 3.5.0`。

  ### React Native SDK 3.6.0

  CloudX React Native 3.6.0 使包装层与 CloudX iOS 3.6.0 和 Android 4.4.0 对齐。本次发布新增 App Open 和发布商上报收入 API，更新原生依赖版本，并保持现有横幅、MREC、插页式和激励视频集成无需迁移。

  #### 新增

  * **App Open 广告** - 新增 `CloudXAppOpenAd` 和 `useCloudXAppOpen`，用于应用启动和回到前台时展示的全屏广告位，由 CloudX iOS 和 Android 的原生 App Open 支持提供能力。
  * **发布商上报收入 API** - 新增 `CloudX.reportRevenueData()` 和 `CloudXRevenueData`，应用可将聚合平台的 paid event 转发到 CloudX 报表。收入请以 JavaScript `number` 传入货币单位，而不是 micros。
  * **扩展原生适配器设置** - React Native 应用可使用本次发布对应的原生适配器集合，包括 iOS 独立版本适配器 pin 和 Android TaurusX 适配器。

  #### 变更

  * 底层原生 SDK 版本更新为 iOS `CloudXCore ~> 3.6.0` 和 Android `io.cloudx:sdk:4.4.0`。
  * **(iOS) 从设置中移除 `CloudXRenderer`** - React Native Podfile 中不要再添加 `CloudXRenderer`。从 iOS 3.5.0 开始，渲染器功能已内置于 `CloudXCore`。
  * **(iOS) 独立适配器版本** - iOS 设置现在使用独立的适配器版本和 `CloudXMagniteAdapterV2`，与 iOS 3.5+ 原生打包模型保持一致。
  * **(Android) 更安全的加载和预取行为** - 包含 Android 4.3.0 对重复 `load()` 调用和过期 Google Waterfall 预取填充的改进。

  #### 修复

  * **(iOS) CloudX 投放素材渲染** - 包含 iOS 3.6.0 对空白横幅/MREC 素材以及 HTML 激励素材被拒绝的问题修复。
  * **(Android) 运行时兼容性** - 包含 Android 4.4.0 对电话权限检查以及在 SDK 最低 Android 版本上 VAST tracker 兼容性的修复。
  * **(Android) 原生广告展示收入** - 包含 Android 4.3.0 对同步原生广告展示收入回调可靠性的修复。

  #### 平台支持

  * iOS：CloudXCore \~> 3.6.0
  * Android：io.cloudx:sdk:4.4.0

  ### Unity SDK 4.4.0

  #### 新功能

  * 新增 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 更新日志](/zh/android/changelog#440---2026-07-28)
  * 将 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。
</Update>

<Update label="2026年7月28日" tags={["Android","iOS","React Native","Demand"]}>
  ### Android SDK 4.4.0

  #### 新增

  * **发布商收益平台** - 发布商上报收益时，现在除 AdMob 外还可使用 `CloudXRevenuePlatform.INMOBI`、`CloudXRevenuePlatform.TOPON` 或 `CloudXRevenuePlatform.custom(name)`，便于从更多中介和报告平台转发展示级收入。

  #### 变更

  * **收益金额单位** - `CloudXRevenueData.builder(platform, revenue, adFormat)` 现在将 `revenue` 作为货币单位的 `Double` 传入，`CloudXRevenueData.revenue` 现在也是 `Double`。对于 AdMob `AdValue.valueMicros`，请先除以 `1_000_000.0` 再创建 `CloudXRevenueData`。

  #### 修复

  * **电话网络权限检查** - SDK 现在会在读取电话网络类型前检查 phone-state 权限。
  * **VAST 跟踪器兼容性** - 修复 VAST 事件跟踪器，避免在 SDK 支持的最低 Android 版本上调用仅 API 24 支持的集合方法。

  ### iOS SDK 3.6.0

  安装：`pod 'CloudXCore', '~> 3.6'`

  #### 新增

  * **从您的聚合平台上报展示级别收入** — 通过 `reportRevenueData(_:)` 将付费事件转发至 CloudX。AdMob、InMobi 和 TopOn 为内置平台。
  * **应用级广告收入代理** — 通过单个 `CLXAdRevenueDelegate` 接收每一次 CloudX 获胜展示的收入，无需在每个广告上单独设置。使用 `addAdRevenueDelegate(_:)` 注册。
  * **AppsFlyer 广告收入连接器** — 将 CloudX 展示收入转发至 AppsFlyer。安装：`pod 'CloudXAppsFlyerConnector', '~> 1.0.0'`。需要 `AppsFlyerFramework >= 6.15.0`。
  * **Adjust 广告收入连接器** — 将 CloudX 展示收入转发至 Adjust。安装：`pod 'CloudXAdjustConnector', '~> 1.0.0'`。需要 `Adjust >= 5.0.0`。

  #### 修复

  * **横幅和中矩形创意在 CloudX 渲染器上可能渲染为空白** — 创意可能在首次加载和刷新后构建失败，表现为空白展示。这些创意现在可以正确渲染。
  * **HTML 激励创意在 CloudX 渲染器上被拒绝** — 渲染器此前仅接受 VAST 激励创意，因此 HTML 激励广告无法加载。HTML 激励创意现在可以正常渲染。

  #### 移除

  * **内部头文件从 `CloudXCore.h` 伞头文件中移除** — 内部实现头文件已从伞头文件中移除；它们均不可被链接，因此不影响任何集成。请通过 `reportRevenueData(_:)` 及公开的收入类型上报收入。

  ### React Native SDK 3.4.7

  新增 React Native 布局内横幅和 MREC 组件 API，同时保留现有程序化叠加 API。

  #### 新增

  * **组件横幅和 MREC 视图** - 发布商现在可以在 React Native 布局中直接渲染 `CloudXBannerView` 和 `CloudXMRECView`，广告会参与普通视图定位、安全区域处理和覆盖层层级顺序。
  * **声明式组件元数据** - 组件横幅和 MREC 支持 `placement`、`customData` 和 `extraParameters` props，用于报表统计以及广告网络或服务端配置。
  * **组件回调** - 组件视图支持 `onAdLoaded`、`onAdLoadFailed`、`onAdClicked` 和 `onAdRevenuePaid` 回调 props。

  #### 变更

  * 将底层 Android 原生依赖更新为 `io.cloudx:sdk:4.1.7`（iOS `CloudXCore ~> 3.4.5` 保持不变）。
  * 对于需要固定原生叠加定位的应用，现有 `CloudXBannerAd` 和 `CloudXMRECAd` 程序化叠加 API 仍可继续使用。

  #### 平台支持

  * iOS：CloudXCore \~> 3.4.5
  * Android：io.cloudx:sdk:4.1.7

  ### 需求合作伙伴 — zstd 竞价压缩

  CloudX 现已支持对与需求合作伙伴交换的 OpenRTB 竞价请求和竞价响应使用 zstd 压缩。

  * 竞价请求可以通过 `Content-Encoding: zstd` 发送；仍支持 gzip。
  * 当 CloudX 声明 `Accept-Encoding: gzip, zstd` 时，需求合作伙伴可以使用 gzip 或 zstd 响应。
  * 请联系 CloudX，为您的竞价端点启用 zstd。

  [阅读文档 →](/zh/demand/compression)
</Update>

<Update label="2026年7月27日" tags={["Dashboard"]}>
  ### Dashboard — 广告位置覆盖值

  现在，您可以在 Dashboard 中创建或编辑广告单元时，设置发送给竞价方的广告位置回传信号。

  准确的位置回传信号可帮助竞价方了解广告在屏幕上的实际展示位置，从而更准确地评估竞价机会。

  * 保持**默认（推荐）**，即可使用 CloudX 当前的默认值：横幅广告发送 `1`（首屏），MREC 不发送位置回传信号，全屏广告格式发送 `7`（全屏）。
  * 当广告的实际展示位置与默认值不符时，可选择 `0` 到 `7` 之间的值。
  * 重新选择\*\*默认（推荐）\*\*即可清除已保存的覆盖值。

  此设置只会更改发送给竞价方的 OpenRTB/AdCOM `banner.pos` 或 `video.pos` 字段，不会重新定位应用中的广告。[阅读文档 →](/zh/dashboard/ad-units#广告位置回传信号)

  ### Dashboard — 手动底价的 IFA 状态定向

  手动订单项底价现在可以根据设备是否提供可用的广告标识符来定向请求。

  * 选择**不限 IFA**，不限制 IFA 状态。
  * 选择**有 IFA**，定向具有可用广告标识符的请求。
  * 选择**无 IFA**，定向广告标识符为空字符串、仅含空白字符、不可用或为 nil UUID（`00000000-0000-0000-0000-000000000000`）的请求。
  * 将 IFA 状态与国家/地区定向组合，为不同流量群体设置不同底价。

  在 YAML 配置中，省略 `ifa_present` 表示**不限 IFA**，设置 `ifa_present: true` 表示**有 IFA**，设置 `ifa_present: false` 表示**无 IFA**。
</Update>

<Update label="2026年7月22日" tags={["Dashboard"]}>
  ### Dashboard — CloudX Agent

  CloudX Agent 现已通过 **Ask CloudX** 在整个 Dashboard 中提供。它会将当前页面作为上下文，并可处理广告库存、配置、报表、竞价数据和 CloudX 产品文档相关任务。

  您可以用它：

  * 分析定价机会，并按广告单元、国家或广告格式准备底价变更
  * 创建、监控、结束和推广 A/B 测试
  * 管理竞价方参与状态和广告网络映射
  * 诊断 eCPM 和填充率变化
  * 验证广告库存，并从 CSV 或电子表格文件导入配置
  * 将已发布的变更追溯到具体配置版本、时间和操作人

  配置变更需要先在对话中审查并明确批准，CloudX 才会进行验证和发布。[阅读文档 →](/zh/dashboard/ai-agent)
</Update>

<Update label="2026年7月21日" tags={["Android","iOS"]}>
  ### Android SDK 4.3.0

  #### 新增

  * **AppsFlyer 广告收益连接器** - 新增托管式 AppsFlyer 连接器与全局 `CloudX.addAdRevenueListener()` API，一个依赖、无需胶水代码即可将 CloudX 广告收益转发到 AppsFlyer 或任意 MMP。监听器每次竞得展示时触发一次，覆盖所有广告格式。

  #### 变更

  * **Google Waterfall Prefetch 过期** - 预取的 Google Waterfall 填充现在按格式设置过期时限（App Open 为 4 小时，其他格式为 1 小时）并主动重新填充，避免陈旧的缓存填充在展示时渲染空白或失败。
  * **重复 load() 处理** - 在一次加载进行中时重复调用 `load()` 现在会在所有广告格式上以安全、一致的方式处理。此前快速重复的 Banner 和 MREC 加载可能取消进行中的竞价，导致应用无法获得填充。
  * **创意报告** - 创意标识现在会包含在 Native 和基于 Mintegral 的广告位的展示与收益遥测中，使创意级报告更准确。

  #### 修复

  * **初始化前的 load 回调** - 在初始化完成前发出的 Banner 和 MREC `load()` 调用现在会被排队并始终产生回调。此前此类调用可能被静默丢弃；初始化失败现在会作为加载失败上报，而不是无回调地挂起。
  * **Native 展示收益** - 修复了一处计时问题：在 SDK 观察者订阅之前触发的 Native 展示可能丢失，导致发布商的收益回调不触发。影响同步触发展示的 Native 路径，例如 Moloco 独立 Native。
  * **乐观加载 Banner 泄漏** - 修复了乐观加载的 Banner 在其后台创意加载派发之前被销毁时的适配器视图泄漏。

  ### iOS SDK — Google Waterfall 适配器 13.6.0.1

  #### 修复

  * **预取的 Google 广告可能在过期后仍被展示** — 预取的填充现在会在过期前于后台刷新，防止空白渲染。安装：`pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.1'`。需要 `CloudXCore >= 3.5.0`。

  ***

  ### 离线适配器版本（-core34）- 2026-07-16

  为仍在使用 `CloudXCore` 3.4.x 的发布商提供的三个适配器离线构建版本。每个版本兼容 `CloudXCore` 3.4.5 或 3.4.6，**不**兼容 `CloudXCore` 3.5.x。请锁定所示的确切版本 — `pod update` 不会自动解析这些版本。

  * **Google Waterfall** — `pod 'CloudXGoogleWaterfallAdapter', '13.0.0.0-core34'`。基于 Google Mobile Ads SDK 13.0.0。需要 `CloudXCore >= 3.4.6, < 3.5`。
  * **Unity Ads** — `pod 'CloudXUnityAdsAdapter', '4.16.5.0-core34'`。基于 UnityAds 4.16.5。需要 `CloudXCore >= 3.4.5, < 3.5`。奖励在广告完整观看后发放；UnityAds 4.16.5 不提供广告过期回调，因此不会收到过期创意的信号。
  * **Moloco** — `pod 'CloudXMolocoAdapter', '4.3.0.0-core34'`。基于 MolocoSDKiOS 4.3.0。需要 `CloudXCore >= 3.4.5, < 3.5`。
</Update>

<Update label="2026年7月17日" tags={["CLI"]}>
  ### CloudX CLI 0.36

  #### 展示级收入导出

  CloudX CLI 0.36 新增异步的全天展示级收入导出，用于账户范围的数据分析与核对。

  #### 新增

  * **展示级 CSV 导出** — 新增 `cloudx report impressions export --date YYYY-MM-DD`，用于创建或复用 gzip 压缩的 CSV，每一行对应一条展示记录。支持导出过去 45 天内已经结束的 UTC 日期。[阅读文档 →](/zh/cli/reporting#cloudx-report-impressions-export)
  * **精细导出过滤** — 可按应用 ID 或包名、广告单元 ID、国家、设备 OS、竞价方、订单项以及生产/测试流量过滤。
  * **异步下载工作流** — 使用 `--wait` 轮询任务状态，或使用 `--output <路径>` 等待任务完成并通过短期有效 URL 安全下载结果。

  ```bash theme={null}
  cloudx report impressions export --date 2026-07-16 --output ./impressions-2026-07-16.csv.gz
  ```
</Update>

<Update label="2026年7月8日" tags={["iOS"]}>
  ### iOS SDK — MobileFuse 适配器 1.11.0.0

  #### 新增

  * **MobileFuse 适配器** — 全新的 `CloudXMobileFuseAdapter`，支持横幅、MREC、插屏和激励广告。安装：`pod 'CloudXMobileFuseAdapter', '~> 1.11.0.0'`。基于 MobileFuse SDK 1.11.0；需要 `CloudXCore >= 3.5.0`。
</Update>

<Update label="2026年7月7日" tags={["Android","iOS"]}>
  ### Android SDK 4.2.0

  #### 新增

  * **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 价格与单次展示收益出价比较前先进行单位规范化。

  ### iOS SDK 3.5.0

  适配器现在与 `CloudXCore` 独立版本化。每个适配器 pod 使用 `<第三方 SDK 版本>.<适配器修订号>` 格式（例如 `pod 'CloudXVungleAdapter', '~> 7.7.4.0'`），每次发布对应一个确切的第三方 SDK 版本。`CloudXCore` 继续使用 SDK 语义化版本（`pod 'CloudXCore', '~> 3.5'`）。

  #### 破坏性变更

  * **适配器 pod 不再与 `CloudXCore` 共享版本号。** 旧的统一版本线上的现有版本锁定（`~> 3.4`、`~> 3.x`）将无法解析新的适配器发布版本。请为每个适配器独立更新版本锁定，例如 `pod 'CloudXMintegralAdapter', '~> 8.1.5.0'`。
  * **`CloudXMagniteAdapterV2` 取代 `CloudXMagniteAdapter` 用于独立版本化。** 安装 `pod 'CloudXMagniteAdapterV2', '~> 1.0.0.0'` 迁移到新版本线；旧 pod 保留在旧版本线。无需修改源代码 — import 名称不变。
  * **`CloudXRenderer` 不再是独立的 pod。** 其功能已内置于 `CloudXCore`；请从 Podfile 中移除任何直接的 `CloudXRenderer` 依赖。

  #### 新增

  * **Trusted Arbiter 自定义出价** — 新增 `CLXArbiterBid.custom(...)`、`CLXArbiterPlatform.custom` 和 `CLXArbiterPrecision`，支持与具体聚合平台无关的自定义出价输入。
  * **App Open 广告格式** — 全新的 `CLXAppOpen` 广告类，用于应用启动或返回前台时展示的全屏广告。通过 `createAppOpen(adUnitId:)` 创建。支持 Google Waterfall、Mintegral、Pangle 和 Vungle 适配器。
  * **CloudX 渲染器支持 VAST 视频插屏与激励视频** — CloudX 渲染器现可投放 VAST 视频插屏和激励素材，并支持 Open Measurement（OMID）视频可见性测量。发布由服务端控制；无需修改集成。
  * **CloudX 渲染器支持 HTML 激励视频** — HTML 激励素材现可通过 CloudX 渲染器渲染，补全了 3.4.5 中为插屏引入的全屏 HTML 支持。服务端控制发布；无需修改集成。
  * **Digital Turbine、Mintegral、Pangle、Verve 和 Google Waterfall 支持原生广告** — 这些适配器现可投放原生素材，支持独立原生和横幅位/中矩形位原生广告。
  * **Google Waterfall — 插屏与激励视频** — `CloudXGoogleWaterfallAdapter` 现可投放全屏插屏和激励视素材，在横幅、中矩形、原生广告和 App Open 之外进一步扩展。
  * **应用内 App Store 弹窗，用于安装类广告点击** — 对于声明了推广应用的 CloudX 渲染素材，点击安装类广告现在会打开应用内 App Store 产品弹窗，而不是跳转离开您的应用。
  * **全屏 HTML 插屏点击跳转** — 由 CloudX 渲染器渲染的全屏 HTML 插屏现在支持点击跳转。
  * **`CloudXMagniteAdapterV2` 1.0.0.1** — 全新的独立版本化 Magnite pod。安装：`pod 'CloudXMagniteAdapterV2', '~> 1.0.0.0'`。底层基于 MagniteSDK 1.0.0。

  #### 变更 — 适配器发布

  * **Vungle** `CloudXVungleAdapter` → `~> 7.7.4.0`（VungleAds 7.7.4）。
  * **Mintegral** `CloudXMintegralAdapter` → `~> 8.1.5.0`（MintegralAdSDK 8.1.5）。
  * **Unity Ads** `CloudXUnityAdsAdapter` → `~> 4.19.0.0`（UnityAds 4.19.0）。
  * **Verve** `CloudXVerveAdapter` → `~> 3.9.0.0`（HyBid 3.9.0）。
  * **Digital Turbine** `CloudXDigitalTurbineAdapter` → `~> 8.4.8.0`（Fyber Marketplace SDK 8.4.8）。
  * **Google Waterfall** `CloudXGoogleWaterfallAdapter` → `~> 13.6.0.0`（Google Mobile Ads SDK 13.6.0 — 从 12.x 升级的主版本更新）。
  * **InMobi** `CloudXInMobiAdapter` → `~> 11.3.0.0`（InMobiSDK 11.3.0）。
  * **Meta** `CloudXMetaAdapter` → `~> 6.21.1.0`（FBAudienceNetwork 6.21.1）。
  * **Moloco** `CloudXMolocoAdapter` → `~> 4.8.0.0`（MolocoSDKiOS 4.8.0）。
  * **Pangle** `CloudXPangleAdapter` → `~> 7.9.1.3.0`（Ads-Global 7.9.1.3）。

  #### 修复

  * **部分竞价方未就某些横幅展示获得计费** — 横幅位原生广告的展示可能被计数但未附带竞价方计费通知，导致竞价方从未获得计费。展示现在均能正确计费。
  * **横幅位或中矩形位原生广告可能过早上报展示** — 横幅位或中矩形位原生广告可能在广告视图实际可见前就触发展示，尤其是在离屏预加载时。展示现在会在正确的时间上报。
  * **渲染崩溃后全屏广告卡住** — 修复了一个问题：全屏广告加载完成后，若其背后的网页内容进程崩溃，用户可能停留在无法关闭的全屏界面。广告现在会自动关闭并派发关闭回调。
  * **紧凑布局下横幅位原生广告可能漏报展示** — 修复了一个问题：使用紧凑模板投放在横幅位的原生广告可能已显示但未登记展示。

  #### 移除

  * **`CloudXRenderer` 独立 pod** — 已合并至 `CloudXCore`。详见上方破坏性变更。
</Update>

<Update label="2026年7月2日" tags={["Unity"]}>
  ### Unity SDK 4.1.7

  #### 新功能

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

  #### SDK 更新

  * 将 Android SDK 从 4.1.5 更新至 4.1.7 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#417---2026-06-25)
  * 将 iOS SDK 从 3.4.5 更新至 3.4.6 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#346---2026-06-29)
</Update>

<Update label="2026年6月29日" tags={["iOS"]}>
  ### iOS SDK 3.4.6

  #### 变更

  * **`CloudXMolocoAdapter` 现已支持完整的 MolocoSDK 4.x 系列** — `MolocoSDKiOS` 版本要求从 `~> 4.6.0` 放宽至 `>= 4.6.0, < 5.0`，可采用更新的 4.x Moloco SDK 版本。这解决了可能阻碍集成的 CocoaPods 依赖冲突。

  #### 修复

  * **广告加载完成时的罕见崩溃** — 修复了横幅或全屏（插屏/激励）广告加载完成时可能发生的罕见崩溃。受影响的广告现在能够可靠地加载并回报结果。
  * **无填充刷新后的横幅广告重复展示计数** — 横幅自动刷新未获得出价时可能重新展示上一个创意并计入额外展示。未获得出价的刷新现在不会展示任何内容，也不会回报展示。
</Update>

<Update label="2026年6月26日" tags={["CLI"]}>
  ### CloudX CLI 0.35

  #### A/B 测试国家定向

  CloudX CLI 0.35 支持直接在终端中的 A/B 测试配置编辑里为测试版本设置地域定向。

  #### 新增

  * **A/B 测试地域定向** — 为 `cloudx config edit create-ab-test` 和 `cloudx config edit update-ab-test` 新增 `--country`。该标志接受重复传入或逗号分隔的 ISO 3166-1 alpha-2 或 alpha-3 国家代码，CloudX 会以 alpha-3 代码保存测试版本定向。[阅读文档 →](/zh/cli/configuration#ab-测试)

  ```bash theme={null}
  cloudx config edit create-ab-test --ad-unit-id au_123 --name "US/GB test" --country US --country GB
  ```
</Update>

<Update label="2026年6月25日" tags={["Android"]}>
  ### Android SDK 4.1.7

  #### 变更

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

  ### Android SDK 4.1.6

  #### 变更

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

<Update label="2026年6月20日" tags={["React Native","Unity"]}>
  ### React Native SDK 3.4.6

  使 React Native 包装层与 CloudX 原生 Android 4.1.5 对齐；iOS 保持 3.4.5。本次发布没有 JavaScript API 变更。

  #### 新增

  * **(Android) MobileFuse 适配器可用** - 现可通过 `io.cloudx:adapter-mobilefuse:1.11.0.0` 在 Android React Native 应用中接入 MobileFuse 需求（横幅、MREC、插页式、激励视频）。
  * **(Android) Pangle 适配器就绪** - 现可通过 `io.cloudx:adapter-pangle:8.1.0.3.0` 在 Android 上接入 Pangle 需求。

  #### 变更

  * 将底层 Android 原生依赖更新为 `io.cloudx:sdk:4.1.5`（iOS `CloudXCore ~> 3.4.5` 保持不变）。
  * **(Android) 启动更快** - 减少了因设备信号采集导致的初始化与广告请求停顿。
  * **(Android) 全屏 HTML 渲染** - SDK 现可在插页式和激励视频广告位渲染 CloudX 投放的全屏 HTML 素材，并支持可见性测量。由服务端控制发布；无需应用改动。
  * **(Android) 更广泛的原生广告入横幅覆盖** - Vungle 原生需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位（与 Meta、Moloco 一起），需在对应订单项中启用。

  #### 修复

  * **(Android) 全屏可靠性** - 全屏 HTML 广告的关闭行为与隐藏回调更可靠，激励视频被提前关闭时的奖励处理更安全。
  * **(Android) 原生广告图片处理** - 原生素材的图片加载更可靠，防止复用广告视图时出现过时图片。

  #### 平台支持

  * iOS：CloudXCore \~> 3.4.5
  * Android：io.cloudx:sdk:4.1.5

  ### Unity SDK 4.1.5

  #### SDK 更新

  * 将 Android SDK 从 4.1.3 更新至 4.1.5 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#415---2026-06-19)
  * 将 iOS SDK 从 3.4.2 更新至 3.4.5 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#345---2026-06-12)
  * 新增 Android 和 iOS 的 Pangle 适配器支持
  * 新增 Android 的 MobileFuse 适配器支持
</Update>

<Update label="2026年6月19日" tags={["Android","Dashboard"]}>
  ### Android SDK 4.1.5

  #### 新增

  * **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 广告格式的支持。

  ### Dashboard — A/B 测试结果标签

  A/B 测试 Dashboard 现在会更清晰地区分结果指标和百分点变化。

  * 创建 A/B 测试时，对照组和测试组固定使用 50/50 流量拆分
  * 累计对比指标中加入 ARPU
  * Fill rate 现在表示已填充的竞价响应数除以请求数
  * 面向客户的结果标签使用 Pending、Directional 和 Achieved

  [阅读文档 →](/zh/dashboard/ab-testing)
</Update>

<Update label="2026年6月18日" tags={["Android"]}>
  ### Android SDK 4.1.4

  #### 新增

  * **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 遥测耗时现在使用单调的应用运行时间计时，使诊断数据更可靠。
</Update>

<Update label="2026年6月16日" tags={["React Native"]}>
  ### React Native SDK 3.4.5

  使 React Native 包装层与 CloudX 原生 iOS 3.4.5 对齐；Android 保持 4.1.3。本次发布没有 JavaScript API 变更。

  #### 修复

  * **(iOS) 插页式和激励视频广告现可在旧架构 (Paper) 上正常显示** - 在使用旧版 React Native 架构构建的应用中，全屏广告可能加载成功但无法显示。现已可正常展示。新架构 (Fabric) 应用不受影响。
  * **(iOS) 部分有效的 HTML 横幅和 MREC 素材不再被跳过** - 之前被误判为损坏的素材现可正常渲染。
  * **(iOS) Meta 和 Moloco 原生广告可靠性** - 原生广告入横幅及入 MREC 素材的资源校验与注册更可靠，展示与点击跟踪更稳定。
  * **(iOS) Digital Turbine 启动冲突** - 当另一个聚合 SDK 先初始化共享的 Fyber SDK 时，CloudX 适配器现会延后处理而非重新初始化。为获得最顺畅的启动流程，请先初始化另一个聚合 SDK，再初始化 CloudX。

  #### 变更

  * 将底层 iOS 原生依赖更新为 `CloudXCore ~> 3.4.5`（Android `io.cloudx:sdk:4.1.3` 保持不变）。请将 iOS 的 `CloudX*` 适配器 pod 同步更新为 `~> 3.4.5`。
  * **(iOS) 更广泛的原生广告入横幅覆盖** - InMobi 和 Vungle 的原生需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位（与 Meta、Moloco 一起），需在对应订单项中启用。
  * **(iOS) HTML 插页式渲染** - CloudX 渲染器现支持全屏 HTML 插页式素材。由服务端控制发布；无需应用改动。
  * **(iOS) 慢速广告网络不再拖慢启动** - 若某网络 SDK 初始化较慢，CloudX 初始化将不等待它直接完成，该网络在初始化完成后自动加入后续竞价。

  #### 平台支持

  * iOS：CloudXCore \~> 3.4.5
  * Android：io.cloudx:sdk:4.1.3
</Update>

<Update label="2026年6月12日" tags={["iOS","React Native"]}>
  ### iOS SDK 3.4.5

  #### 新增

  * **InMobi、Meta、Vungle 和 Moloco 全面支持原生广告** — 本次新增 InMobi 原生与 Vungle 独立原生后，这四家需求方现已支持 CloudX 的所有原生形式：独立原生（通过 `CLXNativeAdLoader`）和横幅位/中矩形位原生广告。
  * **InMobi 原生广告** — `CloudXInMobiAdapter` 现已支持原生广告，包括独立原生广告（通过 `CLXNativeAdLoader`）以及横幅/中矩形位中的原生广告。需要 `InMobiSDK >= 11.2.0`（适配器最低版本要求已从 `11.0.0` 提升）。
  * **Vungle 独立原生广告** — `CloudXVungleAdapter` 现已支持通过 `CLXNativeAdLoader` 投放独立原生广告（横幅/中矩形位中的原生广告此前已支持）。
  * **CloudX 渲染器支持 HTML 插屏广告** — CloudX 渲染器现已支持全屏 HTML 插屏创意（含 MRAID 3.0），与现有的 HTML 横幅/中矩形支持并列。该功能由服务端控制灰度发布，无需修改集成代码。

  #### 变更

  * **较慢的广告网络 SDK 不再拖慢 CloudX SDK 初始化** — 较慢的网络 SDK 不再阻塞初始化；CloudX 不再等待即可完成，该网络就绪后自动加入后续竞价。尚未初始化的网络会被排除在其无法响应的竞价之外。

  #### 修复

  * **Digital Turbine 适配器不再与其他先初始化 Fyber SDK 的聚合 SDK 冲突** — 若其他聚合 SDK 先初始化共享 Fyber SDK，CloudX 适配器现在会让步而非重新初始化。为获得平滑启动，请先初始化其他 SDK，再初始化 CloudX。
  * **部分有效的 HTML 横幅创意被渲染器拒绝** — 修复了包含加载失败的追踪像素的 HTML 横幅/中矩形创意被误判为损坏而不展示的问题。此类创意现已能正常渲染。
  * **Meta 与 Moloco 原生广告可靠性提升** — Meta 原生广告现在会校验加载的广告，并为所有素材视图注册展示和点击跟踪，而不仅限于 CTA。Moloco 原生广告在底层广告不可渲染时不再交付。

  #### 移除

  * **适配器集成 API** — 从适配器层面移除 `clx_isFlexibleSize`、`+isInitialized` 和按实例的 `sdkVersion`。这些对应用集成没有作用；标准发布商集成不受影响。

  ### React Native SDK 3.4.4

  使 React Native 包装层与 CloudX 原生 SDK 对齐 — iOS 3.4.4 和 Android 4.1.3。本次发布没有 JavaScript API 变更；应用通过现有 React Native API 即可获得原生平台改进和更丰富的适配器阵容。

  #### 新增

  * **Digital Turbine 适配器支持** - 双平台均可在 React Native 应用中接入 Digital Turbine 广告需求（横幅、MREC、插页式、激励视频）。iOS：`pod 'CloudXDigitalTurbineAdapter', '~> 3.4.4'`；Android：`io.cloudx:adapter-digitalturbine:8.4.5.0`。
  * **(iOS) Pangle 适配器** - `pod 'CloudXPangleAdapter', '~> 3.4.4'`（横幅/MREC、插页式、激励视频）。
  * **(iOS) Google Waterfall 适配器** - `pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.4'`（横幅、MREC）；需要在应用的 Info.plist 中配置 Google 广告应用标识符。
  * **(Android) 原生广告入横幅渲染** - 来自受支持网络（Meta、Moloco、Vungle）的原生广告需求现可通过现有横幅 API 投放到标准横幅和 MREC 广告位。

  #### 变更

  * 底层原生 SDK 版本更新为 iOS `CloudXCore ~> 3.4.4` 和 Android `io.cloudx:sdk:4.1.3`。
  * **(Android) 更具韧性的适配器初始化** - 缓慢的广告网络不再拖慢 SDK 启动；未就绪的适配器会暂不参与竞价，就绪后自动加入。
  * **(Android) 服务端控制的始终发放奖励模式** - 可在控制台按 line item 配置保证触发奖励回调，无需应用侧改动。

  #### 修复

  * **(iOS) App Store 提交被拒** - 移除了 SDK 二进制中可能导致 App Store 审核被拒的受限 URL scheme。
  * **(iOS) 部分账户 SDK 初始化失败** - 没有组织标识符的账户现在也能正常完成初始化。
  * **(iOS) Google Waterfall 丢单** - 响应较慢但最终成功的瀑布流响应不再被丢弃，提升填充可靠性。
  * **(iOS) Digital Turbine 兼容性** - 横幅、MREC、插页式和激励视频现已兼容 Fyber 8.x 全系列版本。

  #### 平台支持

  * iOS: CloudXCore \~> 3.4.4
  * Android: io.cloudx:sdk:4.1.3
</Update>

<Update label="2026年6月4日" tags={["Dashboard"]}>
  ### Dashboard — 帮助菜单资源

  <img src="https://mintcdn.com/cloudx-928dcb24/z_PsOpojihp-l1VS/images/help-menu-changelog-zh.png?fit=max&auto=format&n=z_PsOpojihp-l1VS&q=85&s=f4c76ca03e6204debe08b856a5fce7af" alt="控制台帮助菜单中的更新日志预览" width="1446" height="886" data-path="images/help-menu-changelog-zh.png" />

  Dashboard 的**帮助**菜单现已集中提供产品帮助、支持入口和发布更新。

  打开侧边栏中的**帮助**后，您可以：

  * 打开 CloudX 文档
  * 联系支持团队
  * 在**最新动态**中浏览最近的发布条目
  * 点击某条更新，在应用内更新日志对话框中查看详情
  * 通过**更新日志**跳转到完整的文档时间线
</Update>

<Update label="2026年6月2日" tags={["iOS"]}>
  ### iOS SDK 3.4.4

  #### 修复

  * **Digital Turbine 适配器在 Fyber Marketplace SDK 低于 8.4.0 时无法链接** — 适配器在 Fyber SDK 低于 `8.4.0` 时链接失败。现已可在整个 `8.x` 系列正常链接 — 横幅、中矩形、插屏和激励广告在 Fyber `8.0.0`+ 可用；原生填充仍需 `8.4.0`+。
  * **Google Waterfall — 中介响应较慢时偶尔丢失填充** — Google Waterfall 广告的中介瀑布流响应较慢时可能被丢弃，即使最终成功填充。响应较慢但成功的填充现已能正常交付，提升填充可靠性。
</Update>

<Update label="2026年6月1日" tags={["iOS","Unity"]}>
  ### iOS SDK 3.4.3

  #### 新增

  * **Pangle 适配器** — 全新的 `CloudXPangleAdapter`，支持横幅/中矩形、插屏和激励广告。安装：`pod 'CloudXPangleAdapter', '~> 3.4.3'`。底层基于 Pangle（字节跳动）SDK `Ads-Global ~> 7.9.0`。

  #### 变更

  * **DigitalTurbine 适配器 — 更广泛的 Fyber Marketplace SDK 兼容性** — `CloudXDigitalTurbineAdapter` 现接受 `Fyber_Marketplace_SDK >= 8.0.0`（此前 `>= 8.4.0`）。横幅、中矩形、插屏和激励广告在整个 8.x 系列可用；原生填充仍需 Fyber SDK 8.4.0+。

  #### 修复

  * **`itms-services` URL scheme 导致的 App Store 提审被拒** — 已从 SDK 二进制文件中移除该 scheme；商店跳转不受影响。
  * **部分账户的 SDK 初始化可能失败** — 修复了没有组织标识符的账户初始化失败的问题。

  ### Unity SDK 4.1.3

  #### SDK 更新

  * 将 Android SDK 从 4.1.1 更新至 4.1.3 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#413---2026-05-31)
  * 将 iOS SDK 从 3.4.1 更新至 3.4.2 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#342---2026-05-29)
  * 新增 Android 和 iOS 的 Google Waterfall 和 Digital Turbine 适配器支持
</Update>

<Update label="2026年5月31日" tags={["Android"]}>
  ### Android SDK 4.1.3

  #### 变更

  * **更具弹性的适配器初始化** - 较慢的广告网络适配器不再阻塞 SDK 初始化。每个适配器有软初始化超时；超时后 SDK 完成初始化，适配器继续在后台启动。未就绪的适配器会被排除在竞价之外，直到完成初始化。
</Update>

<Update label="2026年5月29日" tags={["iOS","CLI","API"]}>
  ### iOS SDK 3.4.2

  #### 新增

  * **Google Waterfall 适配器** — 全新的 `CloudXGoogleWaterfallAdapter`（横幅、中矩形）。通过 CocoaPods（`pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.2'`）或 SPM 安装。基于 `Google-Mobile-Ads-SDK 12.14.0`；需要在 Info.plist 中配置 `GADApplicationIdentifier`。

  ### CloudX CLI 0.34

  #### 扩展配置写入

  CloudX CLI 0.34 将 `cloudx config edit` 从订单项扩展到应用、广告单元、广告单元组、列表、标签、测试设备、网络映射和 A/B 测试生命周期命令。

  #### 新增

  * **库存草稿编辑** — 为主要库存实体新增创建、更新、删除和 upsert 命令。除特别说明外，草稿编辑会自动验证，仍需使用 `cloudx config publish` 发布。[阅读文档 →](/zh/cli/configuration#cloudx-config-edit)
  * **A/B 测试写入** — 新增 A/B 测试创建、更新、开始、结束、提升和删除命令。生命周期变更会立即发布生成的配置。[阅读文档 →](/zh/cli/configuration#cloudx-config-edit)

  ### CloudX API — 配置写入

  公共 API 现在通过 `POST /config/edit` 提供带类型的配置写入操作，覆盖应用、广告单元、广告单元组、列表、标签、测试设备、网络映射、订单项和 A/B 测试。
</Update>

<Update label="2026年5月28日" tags={["Android"]}>
  ### Android SDK 4.1.2

  #### 新增

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

  #### 变更

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

<Update label="2026年5月27日" tags={["iOS","Unity"]}>
  ### iOS SDK 3.4.1

  #### 新增

  * **Digital Turbine 适配器** — 全新的 `CloudXDigitalTurbineAdapter`（横幅、中矩形、插屏、激励、原生）。安装：`pod 'CloudXDigitalTurbineAdapter', '~> 3.4.1'`。底层基于 `Fyber_Marketplace_SDK >= 8.4.0, < 9.0`。

  #### 修复

  * **横幅刷新时 `didLoadAd` / `didShowAd` 回调重复** — 当合作伙伴适配器 SDK 多次触发加载或展示回调时，发布者可能收到重复回调。现在首次回调被视为标准回调，重复触发会被丢弃，每个广告精确一次加载和一次展示。

  ### Unity SDK 4.1.0

  #### 新功能

  * 新增 `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 更新日志](/zh/android/changelog#411---2026-05-27)
  * 将 iOS SDK 从 3.2.0 更新至 3.4.1 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#341---2026-05-27)
  * 新增 Android 和 iOS 的 Moloco 和 Verve 适配器支持
</Update>

<Update label="2026年5月26日" tags={["Android"]}>
  ### Android SDK 4.1.1

  #### 新增

  * **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 新增备用展示上报。
</Update>

<Update label="2026年5月25日" tags={["React Native"]}>
  ### React Native SDK 3.4.0

  #### 新增

  * **Trusted Arbiter** - 新增支持将 CloudX 出价与 Unity LevelPlay、PubMatic 等受支持的第三方出价进行比较，并通过 CloudX 仲裁选择胜出平台。
  * **广告元数据** - 新增 `CloudXAdInfo.adValues`，用于读取 SDK 提供的已加载广告元数据，可用于 Trusted Arbiter 等功能。
  * **更多适配器覆盖** - 更新 iOS 和 Android 最新支持适配器的安装说明，包括底层原生 SDK 支持的 Google Waterfall、Moloco 和 Verve。

  #### 变更

  * 底层原生 SDK 版本更新为 iOS `CloudXCore ~> 3.4.0` 和 Android `io.cloudx:sdk:4.1.0`。

  #### 平台支持

  * iOS: CloudXCore \~> 3.4.0
  * Android: io.cloudx:sdk:4.1.0
</Update>

<Update label="2026年5月22日" tags={["Android","iOS"]}>
  ### Android SDK 4.1.0

  #### 新增

  * **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 素材的支持。

  ### iOS SDK 3.4.0

  #### 新增

  * **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 调用以内联方式触发。运行时行为无变化。

  #### 修复

  * **长会话期间的原生广告内存泄漏** — 长期运行、加载大量原生广告的发布方集成不再在每次原生广告刷新周期累积保留观察者。
</Update>

<Update label="2026年5月21日" tags={["CLI"]}>
  ### CloudX CLI 0.33

  #### 配置验证、订单项编辑与发布

  CloudX CLI 0.33 现在支持直接在配置工作流中编辑订单项、发布已评审的草稿，并可验证本地 YAML 文件和远程配置。

  要将现有的 Homebrew 安装升级到此版本：

  ```bash theme={null}
  brew upgrade cloudx
  ```

  #### 新增

  * **配置验证** — 新增 `cloudx config validate [file]`，可验证本地 YAML 文件，也可远程验证实时配置、已发布版本或按 ID 指定的草稿。使用 `--strict` 可在出现警告时失败。[阅读文档 →](/zh/cli/configuration#cloudx-config-validate)
  * **订单项写入** — 新增 `cloudx config edit create-line-item`、`cloudx config edit update-line-item` 和 `cloudx config edit delete-line-item`，用于在配置草稿中准备订单项改动。草稿编辑会运行验证，并且永远不会自动发布。[阅读文档 →](/zh/cli/configuration#cloudx-config-edit)
  * **配置发布** — 新增 `cloudx config publish --id <draft-id>`，用于将已验证的草稿发布为实时配置。[阅读文档 →](/zh/cli/configuration#cloudx-config-publish)
  * **CLI 升级提示** — 当 CloudX API 返回已有更新版本的 CLI 时，CLI 现在会在终端显示升级提示，并链接到更新说明。
</Update>

<Update label="2026年5月15日" tags={["API","Dashboard"]}>
  ### CloudX API — 公共 API 发布

  CloudX 现在提供公共 API，可通过程序化方式访问报表、竞价检查和账号配置数据。API 使用 CloudX API key 作为 [bearer token](/zh/api#认证)，并提供交互式 OpenAPI 参考文档。[阅读文档 →](/zh/api)

  #### 新增

  * **报表端点** — 获取控制台摘要、拆分行、竞价方表现、应用表现、广告单元表现和 CSV 风格导出。
  * **竞价检查端点** — 检查竞价、轮次、出价、ILRD 行以及相关投放明细。
  * **配置端点** — 读取账号的实时、草稿和已发布配置，包括配置历史。

  ### Dashboard — 频次控制

  CloudX Dashboard 现已支持 SSP 频次控制，可同时作用于广告单元和分群。

  您现在可以：

  * 按 `hour`、`day` 或 `session` 为单个广告单元设置频次上限
  * 为特定分群流量设置频次上限
  * 为未携带任何分群的请求设置默认频次上限

  频次控制会在竞价前校验，并在展示成功后计数。因此，一旦受限库存达到上限，CloudX 会返回 no fill，而不会继续投放。广告单元配置方法请参见[管理广告单元](/zh/dashboard/ad-units)。
</Update>

<Update label="2026年5月13日" tags={["CLI"]}>
  ### CloudX CLI 0.32

  要将现有的 Homebrew 安装升级到此版本：

  ```bash theme={null}
  brew upgrade cloudx
  ```

  #### 新增

  * **API Key 认证** — 支持通过 `CLOUDX_API_KEY` 在 CI、定时任务、脚本以及其他非交互式工作流中认证 CLI。API Key 由管理员在 Settings > API Keys 中管理。[阅读文档 →](/zh/cli/authentication#api-key)
  * **CloudX 拆分报表** — `cloudx report breakdown --by <dimensions> --metrics <metrics>` 支持按请求、展示、收入、填充率、eCPM、点击和 CTR 查询 CloudX-only 聚合报表。
  * **报表粒度与控制** — `cloudx report dashboard` 和 `cloudx report export` 支持 `--granularity daily|hourly`；拆分报表可通过 `--granularity hourly`、`--top`、`--bottom` 与 `--having` 使用小时分桶、排序和过滤。
  * **可配置请求超时** — 全局 `cloudx --timeout <duration>` 可设置 API 请求超时。默认仍为 `1m`，最大 `2m`。[阅读文档 →](/zh/cli#根标志)
</Update>

<Update label="2026年5月12日" tags={["React Native"]}>
  ### React Native SDK 3.2.0

  本次发布将 React Native SDK 使用的 CloudX iOS 和 Android 原生 SDK 更新至 3.2.0。从 3.1.2 升级的发布商无需修改 JavaScript API 调用。

  #### 新增

  * **Magnite 适配器支持** — 在 iOS 和 Android 上新增 Magnite 适配器包支持。
  * **改进诊断能力** — 扩展原生事件可见性，便于控制台和运营问题排查。
  * **(Android) 底价控制** — 在广告请求流程中新增原生底价控制支持。

  #### 变更

  * 将底层 iOS 和 Android 原生 SDK 从 3.1.0 更新至 3.2.0。
  * **(Android) 横幅生命周期处理** — 改进横幅视图的挂载和分离行为，使适配器表现更加一致。

  #### 修复

  * **(Android) 适配器发现诊断** — 缺少适配器依赖时提供更清晰的诊断信息。
  * **(Android) 横幅加载错误** — 当广告网络报告横幅已加载但未提供可渲染视图时，返回更明确的加载失败诊断。

  #### 平台支持

  * iOS: CloudXCore \~> 3.2.0
  * Android: io.cloudx:sdk:3.2.0
</Update>

<Update label="2026年5月7日" tags={["CLI"]}>
  ### CloudX CLI 0.31

  #### 跨聚合平台报表来源

  CloudX CLI 0.31 为已转发展示级收入数据的 publisher 增加报表来源过滤。现有报表命令默认仍然只统计 CloudX；在支持的命令中，可以使用 `--source` 显式纳入外部聚合平台 ILRD。

  要将现有的 Homebrew 安装升级到此版本：

  ```bash theme={null}
  brew upgrade cloudx
  ```

  #### 新增

  * **报表来源过滤** — 为 `cloudx report dashboard`、`cloudx report apps` 与 `cloudx report ad-units` 增加 `--source`。使用 `--source all` 查看 CloudX 加所有可用外部聚合平台来源，使用 `--source applovin` 查看单一聚合平台，或使用 `--source cloudx,applovin` 进行并排对比。
  * **按来源统计的报表指标** — 控制台、应用与广告单元报表现在可以纳入外部聚合平台 ILRD，用于收入、展示、eCPM 与收入占比。包含外部聚合平台时，填充率仍然只代表 CloudX，因为外部 ILRD 不包含 CloudX 请求数。
  * **更清晰的来源语义** — `--source` 使用 ILRD 中的聚合平台/平台来源，例如 `applovin`，而不是 `ADMOB_BIDDING` 等下游需求方网络名称。[阅读文档 →](/zh/cli/reporting#来源值)
</Update>

<Update label="2026年5月6日" tags={["CLI"]}>
  ### CloudX CLI 0.30

  #### 竞价列表性能与超时处理

  CloudX CLI 0.30 重点提升较重查询下的竞价检查可靠性，并让超时失败更容易理解。

  要将现有的 Homebrew 安装升级到此版本：

  ```bash theme={null}
  brew upgrade cloudx
  ```

  #### 改进

  * **使用 ILRD 过滤时竞价列表更快** — 改进 `cloudx auction list` 在 ILRD 较多的查询中的性能，尤其是在按外部 ILRD 和聚合平台缩小结果范围时。
  * **更长的默认请求超时时间** — 将 CLI 默认超时时间增加到 60 秒，让较重的请求有更多时间完成。
  * **更清晰的超时错误** — 发生超时时，CLI 现在会显示更清晰的提示，而不是底层网络错误。
  * **更好的超时可见性** — CloudX 支持团队现在可以更容易识别和诊断超时的 CLI 请求。
</Update>

<Update label="2026年5月5日" tags={["CLI"]}>
  ### CloudX CLI 0.29

  #### 竞价与配置检查

  CloudX CLI 0.29 将终端工作流从报表扩展到生产问题排查。现在无需切换到控制台，即可检查竞价、轮次、出价、ILRD 载荷、实时配置、草稿以及已发布配置历史。

  要将现有的 Homebrew 安装升级到此版本：

  ```bash theme={null}
  brew upgrade cloudx
  ```

  #### 新增

  * **竞价检查** — 新增 `cloudx auction list`、`cloudx auction show`、`cloudx auction rounds` 和 `cloudx auction bids`，用于查看竞价记录、关联行、轮次聚合指标、出价与未出价行、底价来源、CloudX ILRD，以及已启用的外部聚合平台 ILRD。[阅读文档 →](/zh/cli/auction-inspection)
  * **配置检查** — 新增 `cloudx config show`，支持查看实时配置、已发布版本、草稿以及通过 ID 指定的配置行；默认输出 YAML，也可通过 JSON 输出用于自动化流程。[阅读文档 →](/zh/cli/configuration)
  * **配置历史** — 新增 `cloudx config history`，支持查看已发布配置历史、按创建者过滤、按最近变更过滤、包含草稿，以及查看发布时的差异摘要。
  * **工作流示例** — 更新 CLI 示例与概览页面，覆盖竞价、配置、JSON 以及报表组合工作流。[查看示例 →](/zh/cli/examples)
</Update>

<Update label="2026年4月28日" tags={["Unity","Dashboard"]}>
  ### Unity SDK 4.0.0

  #### 新功能

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

  #### SDK 更新

  * 将 Android SDK 从 3.2.0 更新至 4.0.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#400---2026-04-28)

  ### Dashboard — A/B 测试

  <img src="https://mintcdn.com/cloudx-928dcb24/zHnaYStoMeMoy9QU/images/ab-tests.png?fit=max&auto=format&n=zHnaYStoMeMoy9QU&q=85&s=3194e1886240f7af4ba69f665eeac3e1" alt="A/B 测试" width="2608" height="1490" data-path="images/ab-tests.png" />

  不必再凭直觉判断新订单项、竞价底价或网络配置的改动是否真正带来效果。**A/B 测试**让您在当前配置与编辑后的变体之间分流展示量，并实时在生产环境中并排对比关键指标——收入、eCPM、填充率与展示量。

  数据出炉后，一键即可上线获胜方案。打开任何启用中的广告单元，点击**创建 A/B 测试**，以严谨的方式优化您的变现策略。[阅读文档 →](/zh/dashboard/ab-testing)
</Update>

<Update label="2026年4月27日" tags={["Android","MCP"]}>
  ### Android SDK 4.0.0

  #### 破坏性变更

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

  #### 新增

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

  #### 变更

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

  #### 修复

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

  ### CloudX MCP — AI 原生的报表与文档检索

  以您习惯的方式获取所需数据。CloudX 现已上线托管的 **Model Context Protocol** 服务器，可直接接入 ChatGPT、Claude Code、Cursor、Codex 以及您选择的任何其他 MCP 客户端——让您的 AI 助手实时从 CloudX 获取收入、填充率、eCPM 和竞价方表现，无需在多个标签页之间反复复制粘贴。

  提问 *"上周美国 iOS 流量表现如何？"*，立即获得真实数据，筛选条件与您在控制台中完全一致。提问 *"如何集成 Magnite 适配器？"*，得到基于真实文档的回答。[阅读文档 →](/en/mcp/installation)
</Update>

<Update label="2026年4月24日" tags={["Android","Unity"]}>
  ### Android SDK 3.2.0

  #### 新增

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

  #### 变更

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

  #### 修复

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

  ### Unity SDK 3.2.0

  #### 新功能

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

  #### SDK 更新

  * 将 Android SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#320---2026-04-24)
  * 将 iOS SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#320---2026-04-22)
  * 新增 Android 和 iOS 的 Magnite 适配器支持
</Update>

<Update label="2026年4月22日" tags={["iOS","CLI"]}>
  ### iOS SDK 3.2.0

  #### 新增

  * **Magnite 适配器** — 全新的 `CloudXMagniteAdapter`（横幅、中矩形、插屏、激励）。安装：`pod 'CloudXMagniteAdapter', '~> 3.2.0'`。
  * **更丰富的仪表盘遥测** — 全面的遥测升级。事件采集更稳健，新增事件类型，整体可观测性显著提升。

  ### CloudX CLI — 在终端里使用 CloudX

  <img src="https://mintcdn.com/cloudx-928dcb24/lauTnLtSAc2kfy_H/images/cli-demo.png?fit=max&auto=format&n=lauTnLtSAc2kfy_H&q=85&s=7f70ec770c10a22f26cef9d781816fba" alt="CLI 控制台报表" width="1750" height="1104" data-path="images/cli-demo.png" />

  并非每个问题都需要打开浏览器。全新的 **CloudX CLI** 让您的日常数据只在一行命令之间——运行 `cloudx report dashboard` 即可在命令行中看到收入、填充率、eCPM 与趋势。按国家、平台、广告单元或测试流量过滤，方式与控制台完全一致。

  需要将数据用于下游分析时，使用 `--json` 输出结构化 JSON，或使用 `cloudx report export` 导出 CSV，直接送入电子表格、Notebook 或其他工具。通过 `brew install cloudx` 安装，登录一次，您的报表工作流便能随您在任何工作环境中使用。[阅读文档 →](/zh/cli)
</Update>

<Update label="2026年4月21日" tags={["React Native"]}>
  ### React Native SDK 3.1.2

  本次主要版本升级使 React Native SDK 与 3.1.0 原生 SDK 对齐，并新增 JavaScript 手动隐私 API。

  <Note>
    **请安装 `3.1.2` 或更高版本 — `3.1.0` 和 `3.1.1` 无法安装。** 此前两个 3.1 版本因 iOS 发布构建问题已从 npm 下架；`3.1.2` 是 3.1 系列首个可安装版本。
  </Note>

  <Note>
    原生广告支持将另行提供，**不**包含在本次发布中。
  </Note>

  #### 新增

  * **手动隐私 API** — `CloudX.setHasUserConsent(value)` 和 `CloudX.setDoNotSell(value)` 可在 iOS 和 Android 上调用原生隐私 API。传入 `boolean` 可设置值，传入 `null` 可清除手动设置并回退到 IAB 存储。
  * **错误码** — `CloudXErrorCode` 新增 `LOAD_NOT_ALLOWED_WHILE_SHOWING` (303) 和 `ADAPTER_INITIALIZATION_TIMEOUT` (622)。

  #### 变更

  底层原生 SDK 从 2.2.3 更新至 3.1.0。平台特定详情请参阅原生更新日志：

  * [iOS 更新日志](/zh/ios/changelog)
  * [Android 更新日志](/zh/android/changelog)

  本 SDK 现固定使用 iOS `CloudXCore ~> 3.1.0` 和 Android `io.cloudx:sdk:3.1.0`，所有捆绑适配器也固定至同一主版本。原生 Android SDK 新增的 `Context` 要求已由桥接层处理，发布商无需修改代码。

  #### 修复

  * **(iOS) Release 构建编译错误** — 修复早期 3.1.0 和 3.1.1 版本导致应用无法归档并提交 App Store 的编译错误。
  * **横幅和 MREC 渲染延迟** — 在部分设备上，横幅或 MREC 可能报告加载成功，但要等到下一次自动刷新（约 30 秒）才显示。现在首次调用 show 时会立即渲染。

  #### 从 2.2.3 升级

  * **(iOS) 移除手动顶部安全区补偿。** 如果你使用 `CloudXBannerAd.createAdWithOffsets` 并把设备顶部安全区高度作为 `yOffset`（例如 `react-native-safe-area-context` 的 `insets.top`），请移除该补偿；额外偏移现在会使横幅偏离到安全区下方。
  * **(iOS) `TOP_CENTER` 和 `BOTTOM_CENTER` 横幅现在会自动位于安全区内。** 默认放置请使用 `CloudXBannerAd.createAd(adUnitId, CloudXAdPosition.TOP_CENTER)`。
  * **横幅和 MREC 视图生命周期。** 横幅和 MREC 现在会在脱离视图层级的状态下加载，并在调用 `showBanner` / `showMREC` 时挂载到 iOS 展示视图控制器或 Android 根内容视图。此项仅面向在 create 和 show 之间检查原生视图层级的发布商。
  * **将横幅和 MREC 预加载到内存。** 由于广告在脱离状态下加载，你现在可以预加载横幅或 MREC 并稍后展示，而不会提前占用父视图。

  #### 平台支持

  * iOS: CloudXCore \~> 3.1.0
  * Android: io.cloudx:sdk:3.1.0
</Update>

<Update label="2026年4月17日" tags={["Android","Unity"]}>
  ### Android SDK 3.1.0

  #### 新增

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

  ### Unity SDK 3.1.0

  #### 新功能

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

  #### 集成说明

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

  #### SDK 更新

  * 将 Android SDK 从 3.0.0 更新至 3.1.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#310---2026-04-17)
  * 将 iOS SDK 从 2.2.8 更新至 3.1.0 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#310---2026-04-16)
</Update>

<Update label="2026年4月16日" tags={["iOS"]}>
  ### iOS SDK 3.1.0

  #### 新增

  * **Meta Reels 与原生广告** — 现已支持 Meta Reels（9:16 竖版视频）及其他 Meta 原生广告格式，通过 `CLXPublisherNative` 集成。本版本仅支持 Meta 原生广告；其他竞价方的支持将在未来版本中推出。
  * **按适配器初始化超时** — SDK 初始化现在支持每个适配器的独立超时设置，启动行为更可预测。

  #### 修复

  * **Xcode 26 兼容性** — 解决了使用 Xcode 26 编译时的构建警告。
</Update>

<Update label="2026年4月9日" tags={["iOS"]}>
  ### iOS SDK 2.2.9

  #### 修复

  * **Unity Ads 适配器** — 修复了初始化、隐私同意转发、激励回调和竞价令牌错误处理，提升了各地区的可靠性。
</Update>

<Update label="2026年4月6日" tags={["Android","Unity"]}>
  ### Android SDK 3.0.0

  #### 破坏性变更

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

  #### 变更

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

  ### Unity SDK 3.0.0

  #### SDK 更新

  * 将 Android SDK 从 2.2.7 更新至 3.0.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#300---2026-04-06)
  * 将 iOS SDK 从 2.2.7 更新至 2.2.8 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#228---2026-04-03)
</Update>

<Update label="2026年4月3日" tags={["iOS"]}>
  ### iOS SDK 2.2.8

  #### 修复

  * **崩溃修复** — 修复了在后台线程上并发进行广告事件追踪时可能发生的崩溃问题
</Update>

<Update label="2026年4月2日" tags={["Android","Unity"]}>
  ### Android SDK 2.2.7

  #### 修复

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

  ### Unity SDK 2.2.7

  #### 新功能

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

  #### 集成说明

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

  #### SDK 更新

  * 将 Android SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#227---2026-04-02)
  * 将 iOS SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#227---2026-04-01)
</Update>

<Update label="2026年4月1日" tags={["Android","iOS","Unity"]}>
  ### Android SDK 2.2.6

  #### 变更

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

  #### 修复

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

  ### iOS SDK 2.2.7

  #### 修复

  * **延迟横幅展示** — 修复了在 SDK 初始化完成之前创建的横幅广告在初始化成功后可能无法展示的问题
  * **Vungle 适配器可靠性** — 修复了 Vungle 激励广告和插屏广告由于链接时方法被错误剥离而在运行时崩溃的问题

  ### Unity SDK 2.2.6

  #### 新功能

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

  #### 集成说明

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

  #### SDK 更新

  * 将 Android SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#226---2026-04-01)
  * 将 iOS SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#226---2026-03-30)
</Update>

<Update label="2026年3月30日" tags={["Android","iOS"]}>
  ### Android SDK 2.2.5

  #### 新增

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

  #### 变更

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

  #### 修复

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

  ### iOS SDK 2.2.6

  #### 新增

  * **Unity Ads 隐私同意** — Unity Ads 适配器现在支持 GDPR 和 CCPA 隐私同意转发
  * **`isAdReady` 支持** — 全屏广告适配器现在支持 `isAdReady`，可在调用 show 之前可靠地查询广告可用性

  #### 修复

  * **横幅可见性准确性** — 修复了设置 `banner.hidden = YES` 不会暂停广告刷新的问题。隐藏的横幅可能继续加载广告而不具备展示资格，可能影响 CPM。
  * **改进依赖兼容性** — 放宽第三方 SDK 版本约束（VungleAds、FBAudienceNetwork、InMobiSDK），防止与其他聚合 SDK 集成时出现 CocoaPods 依赖冲突
  * **全屏广告可靠性** — 修复了广告生命周期回调在罕见情况下可能静默丢失的问题
  * **iOS 16 崩溃修复** — 修复了 iOS 16 设备上与会话追踪相关的崩溃
</Update>

<Update label="2026年3月27日" tags={["Unity"]}>
  ### Unity SDK 2.2.4

  #### 新功能

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

  #### 修复

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

  #### SDK 更新

  * 将 Android SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#224---2026-03-26)
  * 将 iOS SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#224---2026-03-26)
</Update>

<Update label="2026年3月26日" tags={["Android","iOS","React Native"]}>
  ### Android SDK 2.2.4

  #### 新增

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

  #### 变更

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

  #### 修复

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

  ### iOS SDK 2.2.4

  #### 变更

  * **服务端驱动的位置控制** — 竞价请求中的位置坐标共享现在通过 CloudX 控制面板控制（账户级别）。发布商无需更改 SDK 代码。
  * **改进竞价请求数据** — 竞价请求现在包含内容语言，以改善广告定向

  ### React Native SDK 2.2.3

  #### 新增

  * **Unity Ads 适配器** — iOS 和 Android 现支持通过 Unity Ads 提供横幅、插页式和激励视频广告。
  * **Mintegral 适配器** — Mintegral 适配器现已在 iOS 和 Android 上作为正式版本提供。

  #### 改进

  * **全屏广告可靠性** — 修复 iOS 上显示另一个全屏广告时加载可能静默失败的问题，并修复 Android 上在隐藏或展示失败回调中重新加载广告的行为。
  * **错误诊断** — 提升无出价场景的错误可见性，便于排查填充率问题。
  * **减小 SDK 体积** — Android 移除 `appcompat` 和 `webkit` 传递依赖，渲染器现已包含在核心 SDK 模块中。

  #### 变更

  底层原生 SDK 从 2.0.0 更新至 2.2.3。平台特定详情请参阅原生更新日志：

  * [iOS 更新日志](/zh/ios/changelog)
  * [Android 更新日志](/zh/android/changelog)

  #### 平台支持

  * iOS: CloudXCore \~> 2.2.3
  * Android: io.cloudx:sdk:2.2.3
</Update>

<Update label="2026年3月23日" tags={["Unity"]}>
  ### Unity SDK 2.2.3

  #### SDK 更新

  * 将 Android SDK 从 2.2.2 更新至 2.2.3 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#223---2026-03-20)
  * 将 iOS SDK 从 2.2.2 更新至 2.2.3 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#223---2026-03-19)
  * 新增 Android 和 iOS 的 Unity Ads 适配器支持
</Update>

<Update label="2026年3月20日" tags={["Android"]}>
  ### Android SDK 2.2.3

  #### 新增

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

  #### 变更

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

  #### 修复

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

<Update label="2026年3月19日" tags={["iOS"]}>
  ### iOS SDK 2.2.3

  #### 新增

  * **Unity Ads 适配器** — Unity Ads 适配器现已支持横幅、插屏和激励广告

  #### 修复

  * **Unity Ads 初始化** — 修复了 Unity Ads 适配器在某些配置下可能无法正确初始化的问题
</Update>

<Update label="2026年3月17日" tags={["Android","Unity"]}>
  ### Android SDK 2.2.2

  #### 新增

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

  #### 修复

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

  ### Unity SDK 2.2.2

  #### SDK 更新

  * 将 Android SDK 从 2.2.1 更新至 2.2.2 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#222---2026-03-17)
  * 将 iOS SDK 从 2.0.0 更新至 2.2.2 — 详情请参阅 [iOS SDK 更新日志](/zh/ios/changelog#222---2026-03-16)
  * 将 iOS 最低部署目标从 15.0 降低至 13.0
  * 新增 Mintegral 适配器支持（Android + iOS）
</Update>

<Update label="2026年3月16日" tags={["iOS"]}>
  ### iOS SDK 2.2.2

  #### 新增

  * **手动隐私 API** — 新增 `setHasUserConsent:` 和 `setDoNotSell:` 方法，用于发布商控制的隐私同意
  * **Mintegral 适配器** — Mintegral 适配器现已作为标准版本发布

  #### 修复

  * **提升错误可见性** — 提高了无竞价场景的错误可见性，使填充率问题更容易诊断
  * **全屏广告加载** — 修复了在另一个全屏广告展示时加载广告可能静默失败的问题
  * **全屏失败回调** — 修复了全屏广告失败回调中缺少广告单元 ID 的问题
  * **渲染器展示追踪** — 修复了 CloudX Renderer 中的可见性追踪准确性

  #### 变更

  * **Mintegral SDK** — 从 8.0.7 升级到 8.0.8
</Update>

<Update label="2026年3月11日" tags={["Android","Unity"]}>
  ### Android SDK 2.2.1

  #### 变更

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

  #### 修复

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

  ### Unity SDK 2.2.1

  #### SDK 更新

  * 将 Android SDK 从 2.2.0 更新至 2.2.1 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#221---2026-03-11)
  * 新增 Mintegral 适配器及 Maven 仓库（Android）
</Update>

<Update label="2026年3月10日" tags={["Android","Unity"]}>
  ### Android SDK 2.2.0

  #### 新增

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

  ### Unity SDK 2.2.0

  #### SDK 更新

  * 将 Android SDK 从 2.0.1 更新至 2.2.0 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#220---2026-03-10)
</Update>

<Update label="2026年3月5日" tags={["React Native"]}>
  ### React Native SDK 2.0.0

  CloudX React Native SDK 首个稳定版本。

  #### 新增

  * 完整的 SDK 集成：横幅、MREC、插页式和激励视频广告格式
  * 程序化叠加 API：`CloudXBannerAd` 和 `CloudXMRECAd`
  * 全屏广告模块：`CloudXInterstitialAd` 和 `CloudXRewardedAd`
  * React Hooks: `useCloudXInterstitial`, `useCloudXRewarded`, `useCloudXBanner`
  * 隐私合规支持 (CCPA, GDPR, GPP)
  * 用户定向键值对 (`setUserKeyValue`, `setAppKeyValue`)
  * 展示级收入追踪 (`addAdRevenuePaidListener`)
  * App Tracking Transparency (iOS 14+)
  * 展示失败事件 (`addAdFailedToDisplayEventListener`)
  * 完整的 TypeScript 类型定义
  * Fabric (新架构) 和 Paper (旧架构) 支持

  #### 修复 (iOS — 自 2.0.0-beta.1)

  * 修复 `onInterstitialHidden` / `onRewardedAdHidden` 关闭时重复回调
  * 修复激励视频广告收入回调重复触发
  * 修复 bid token 字典构建中的线程安全崩溃
  * `showInterstitial` / `showRewarded` 在 `topViewController` 为 nil 时发送展示失败事件
  * `didFailToLoadAd:` 在 `adUnitId` 为 nil 时广播到所有全屏监听器
  * `rewardAmount` 以 `NSNumber` 而非 `NSString` 发送
  * 改进加载/失败路径的诊断日志

  #### 平台支持

  * iOS: CloudXCore \~> 2.2.0-beta
  * Android: io.cloudx:sdk:2.0.0
</Update>

<Update label="2026年3月4日" tags={["Android","Unity"]}>
  ### Android SDK 2.0.1

  #### 变更

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

  #### 修复

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

  ### Unity SDK 2.0.1

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

  #### 兼容性

  * 新增对 Unity Engine 2022.3 LTS 的支持

  #### SDK 更新

  * 将 Android SDK 从 2.0.0 更新至 2.0.1 — 详情请参阅 [Android SDK 更新日志](/zh/android/changelog#201---2026-03-04)
</Update>

<Update label="2026年2月26日" tags={["React Native"]}>
  ### React Native SDK 2.0.0-beta.1

  #### 新增

  * 完整的 CloudX Core SDK 集成
  * 通过 `CloudXBannerAd` 模块支持横幅广告
  * 通过 `CloudXMRECAd` 模块支持 MREC 广告 (300x250)
  * 通过 `CloudXInterstitialAd` 模块支持插页式广告
  * 通过 `CloudXRewardedAd` 模块支持激励视频广告
  * React Hooks: `useCloudXInterstitial`, `useCloudXRewarded`, `useCloudXBanner`
  * 隐私合规支持 (CCPA, GDPR, GPP)
  * 用户定向键值对
  * 展示级收入追踪
  * App Tracking Transparency (iOS)
  * 完整的 TypeScript 类型定义
  * Fabric (新架构) 和 Paper (旧架构) 支持

  #### 平台支持

  * iOS: CloudXCore \~> 2.1.0-beta
  * Android: io.cloudx:sdk:2.0.0
</Update>

<Update label="2026年2月5日" tags={["Unity"]}>
  ### Unity SDK 2.0.0

  #### 重大变更

  * 横幅广告和 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
</Update>

<Update label="2026年2月4日" tags={["Android","iOS"]}>
  ### Android SDK 2.0.0

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

  ### iOS SDK 2.0.0

  此版本将 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（广告标识符）收集问题
  * 修复国家/地理定向数据收集问题
</Update>

<Update label="2026年1月15日" tags={["Unity"]}>
  ### Unity SDK 0.12.1

  #### 新功能

  * 新增对 iOS 平台的支持

  #### 性能改进

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

  #### SDK 更新

  * 将 Android SDK 从 0.12.0 更新至 0.12.1

  #### 改进

  * 重命名内部 `UnityMainThreadDispatcher` 类，避免与第三方包命名空间冲突
</Update>

<Update label="2025年12月23日" tags={["Android"]}>
  ### Android SDK 0.12.1

  #### 修复

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

  ### Android SDK 0.11.1

  #### 修复

  * 修复 Meta 适配器在主线程收集竞价令牌导致的 ANR 风险。
</Update>

<Update label="2025年12月15日" tags={["Unity"]}>
  ### Unity SDK 0.12.0

  CloudX Unity SDK 初始发布
</Update>

<Update label="2025年12月14日" tags={["Android","iOS"]}>
  ### Android SDK 0.12.0

  #### 破坏性变更

  * 移除 `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 失败处理。

  ### iOS SDK 1.3.0

  #### 新增

  * **横幅刷新重试** - 横幅广告现在在隐藏后会自动重试加载失败的广告

  #### 修复

  * **App Extension 兼容性** - SDK 现在可以在 App Extensions 中正常工作（无 UIApplication 调用）
  * **激励广告代理回调** - 修复回调顺序错误
  * **符号冲突** - 所有分类方法现在都以 `clx_` 为前缀以防止冲突

  #### 变更

  * **CloudXCore 现在以动态框架分发** - 支持 SDK 问题的崩溃符号化
</Update>

<Update label="2025年12月9日" tags={["Android"]}>
  ### Android SDK 0.11.0

  #### 变更

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

<Update label="2025年12月4日" tags={["iOS"]}>
  ### iOS SDK 1.2.1

  #### 新增

  * **可视化调试器按钮** - 用于开发和 QA 的新调试工具
  * **高 ROI 键值定向示例** - 增强的演示应用，包含定向信号示例

  #### 修复

  * 更正 podspecs 中的 vendored\_frameworks 路径
</Update>

<Update label="2025年12月3日" tags={["Android"]}>
  ### Android SDK 0.10.0

  #### 新增

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

  #### 变更

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

  #### 修复

  * 修复 banner 加载失败后刷新停止的问题。
</Update>

<Update label="2025年11月26日" tags={["Android","iOS"]}>
  ### Android SDK 0.9.0

  #### 新增

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

  #### 变更

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

  #### 修复

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

  ### iOS SDK 1.2.0

  #### 🚀 首次正式发布

  CloudX iOS SDK 的初始版本，支持横幅、MREC 和插屏广告。
</Update>

<Update label="2025年11月3日" tags={["Android"]}>
  ### Android SDK 0.6.0

  #### 新增

  * 为 `CloudXInitializationParams` 新增 `testMode` 支持，用于开发期间请求测试广告。
</Update>

<Update label="2025年10月27日" tags={["Android"]}>
  ### Android SDK 0.4.0

  #### 新增

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