更新日志

​

CloudX API — Public API 发布

​

新增

• 报表端点 — 获取 dashboard 摘要、breakdown 行、竞价方表现、应用表现、广告单元表现和 CSV 风格导出。
• 竞价检查端点 — 检查 auctions、rounds、bids、ILRD 行以及相关投放明细。
• 配置端点 — 读取账号的 live、draft 和已发布配置，包括配置历史。

​

CloudX CLI 0.32

brew upgrade cloudx

​

新增

• API Key 认证 — 支持通过 CLOUDX_API_KEY 在 CI、定时任务、脚本以及其他非交互式工作流中认证 CLI。API Key 由管理员在 Settings > API Keys 中管理。阅读文档 →
• 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。阅读文档 →

​

CloudX CLI 0.31

​

跨聚合平台报表来源

brew upgrade cloudx

​

新增

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

​

CloudX CLI 0.30

​

竞价列表性能与超时处理

brew upgrade cloudx

​

改进

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

​

CloudX CLI 0.29

​

竞价与配置检查

brew upgrade cloudx

​

新增

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

​

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 更新日志

​

Dashboard — A/B 测试

​

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

​

Android SDK 3.2.0

​

新增

• Magnite 适配器 — 新增 adapter-magnite，支持 banner、interstitial 和 rewarded，并补齐面向 Magnite 需求的隐私转发、竞价扩展和元数据集成
• 按请求覆盖竞价底价 — 新增 Android 侧按请求覆盖 bid floor 的 API，并扩展 bid request extras 处理能力，使发布商能够通过 SDK 竞价链路传递请求级底价控制

​

变更

• 适配器集成接口 — 将适配器监听器中的 extraInfo 从 map 替换为 Bundle，将 extras 类型重命名为更清晰的 Pub / Adapter 前缀，并改为从 adapter params 上报 SDK 版本，而不是依赖 BuildConfig，从而让适配器获得请求实际使用的版本号
• Banner 生命周期归属调整 — Banner 视图的 attach / detach 处理已从各个适配器中移入 SDK delegate，使不同广告网络的 banner 集成行为更加一致
• 遥测载荷对齐 — Android 遥测现已与 iOS 和后端 wire contract 对齐，TelemetrySdkContext 新增 app version 与 build number，并恢复了遥测端点上的 gzip 压缩，同时将原始 ILRD 广告格式值直接发送给后端

​

修复

• 适配器发现链路加固 — 反射式适配器加载现已集中处理，并会显式跟踪 discovery failure，从而在运行时缺失网络 SDK 类或适配器对象时具备更好的韧性
• Vungle Banner 加载错误可见性 — 当 Vungle 在 onAdLoaded() 中没有返回 banner view 实例时，banner 加载回调现在会明确返回 INVALID_LOAD_STATE，不再让该路径处于模糊状态

​

Unity SDK 3.2.0

​

新功能

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

​

SDK 更新

• 将 Android SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 Android SDK 更新日志
• 将 iOS SDK 从 3.1.0 更新至 3.2.0 — 详情请参阅 iOS SDK 更新日志
• 新增 Android 和 iOS 的 Magnite 适配器支持

​

iOS SDK 3.2.0

​

新增

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

​

CloudX CLI — 在终端里使用 CloudX

​

Android SDK 3.1.0

​

新增

• 原生广告支持 — 新增原生广告支持，包括 CloudX.createNativeAdLoader()、CloudXNativeAdLoader、CloudXNativeAd、CloudXNativeAdListener 和 CloudXNativeLoaderConfiguration，并配套 Meta 适配器与 NATIVE_REEL 广告单元解析
• 可信事件时间戳 — 在遥测事件头中新增 clientTrustedTimestamp，便于后端区分 SDK 侧事件创建时间与实际投递时间

​

变更

• 适配器通信改进 — 适配器初始化、竞价扩展、隐私转发以及 load/show 调用，现统一为基于显式参数对象和回调式异步流程的通信方式
• 启动与线程安全 — 将 user-agent 解析从单例启动阶段移出，支持带超时控制的并行适配器初始化，并减少初始化阶段的主线程工作量，从而降低 ANR 和死锁风险
• 遥测载荷改进 — 重构遥测载荷结构，扩展配置、延迟、身份字段与存储保护逻辑，并关闭遥测请求体的 gzip 压缩
• 运行时加固 — 提升了适配器类加载时缺失网络 SDK 依赖、Unity Ads 初始化、横幅线程、bid token 格式、banner/native 加载异常以及 ad preview bid asset 回退等场景下的稳定性
• Unity 2022 与 Meta 兼容性 — adapter-meta 现在默认传递引入 Meta Audience Network 6.20.0 以兼容 Unity 2022。如果您的集成使用原生广告，请在应用中显式添加 Meta Audience Network 6.21.0 或更高版本

​

Unity SDK 3.1.0

​

新功能

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

​

集成说明

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

​

SDK 更新

• 将 Android SDK 从 3.0.0 更新至 3.1.0 — 详情请参阅 Android SDK 更新日志
• 将 iOS SDK 从 2.2.8 更新至 3.1.0 — 详情请参阅 iOS SDK 更新日志

​

iOS SDK 3.1.0

​

新增

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

​

修复

• Xcode 26 兼容性 — 解决了使用 Xcode 26 编译时的构建警告。

​

iOS SDK 2.2.9

​

修复

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

​

Android SDK 3.0.0

​

破坏性变更

• 公共 SDK API 现在要求显式传入 Android Context — CloudX.initialize() 现在要求传入 Android Context，公共广告创建 API 也同样要求传入 Context：createBanner()、createMREC()、createInterstitial() 和 createRewarded()
• 适配器工厂接口改为直接接收原始 Context — 适配器工厂接口现在直接接收 context: Context，不再使用 CloudXContextProvider；外部适配器需要更新其 create() 签名，并将 contextProvider.getContext() 替换为传入的 context

​

变更

• SDK 内部上下文流改为显式传递 — SDK 不再依赖进程启动阶段的上下文引导。Context 现在会在初始化、广告创建、隐私处理、HTTP 客户端初始化以及内部单例访问中显式传递
• 启动开销与 ANR 风险降低 — SDK 启动初始化器已从 manifest 中移除，从而减少应用启动期间的主线程工作并降低 ANR 风险
• 隐私初始化顺序修正 — 隐私转发现在会按正确的初始化顺序解析 consent，并通过 ManualPrivacyState.onChanged 响应初始化后的手动隐私变更
• 第一方 Metrics 遥测能力扩展 — 第一方 metrics 遥测现在已接入公共 SDK 入口和内部运行时调用点，并通过带类型的 telemetry metric、配置驱动采样以及 MetricsTelemetryTracker 的缓冲投递完成上报

​

移除

• 旧的启动上下文引导链路 — 移除了内部启动上下文引导路径，包括 ApplicationContext、CloudXStartup、CloudXContextProvider 以及内部 ContextProvider 间接层
• ActivityLifecycleService 启动链路 — 移除了 ActivityLifecycleService 及其在 SDK 启动流程中的注册路径

​

Unity SDK 3.0.0

​

SDK 更新

• 将 Android SDK 从 2.2.7 更新至 3.0.0 — 详情请参阅 Android SDK 更新日志
• 将 iOS SDK 从 2.2.7 更新至 2.2.8 — 详情请参阅 iOS SDK 更新日志

​

iOS SDK 2.2.8

​

修复

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

​

Android SDK 2.2.7

​

新增

• 第一方 Metrics 遥测已贯通 SDK 调用链路 — Metrics 遥测现已接入 SDK 调用点、HTTP 计时埋点和遥测收集器，因此方法调用与内部 SDK 指标现在会与现有 metrics tracker 并行进入第一方 metrics 遥测链路

​

变更

• 指标时间戳改为在事件创建时记录 — 指标时间戳现在会在 metric 事件创建时写入，而不是等到 tracker 之后入队时再写入，因此时间数据反映的是 SDK 动作实际发生的时刻
• Activity 生命周期服务显式初始化 — Activity 生命周期跟踪现在通过 ActivityLifecycleService.instance(context) 显式初始化，Jetpack Startup 在注册生命周期跟踪时也会直接传入真实的 application context

​

修复

• 发布商启动 ANR 风险 — 修复 ActivityLifecycleService 初始化过程中的发布商启动 ANR 风险，移除了启动流程中此前的惰性单例和全局查找路径
• SDK Metrics 遥测缺失 — 修复 SDK metrics 遥测事件缺失问题，将 MetricsTelemetryTracker 接入此前只走旧 metrics 路径的运行时调用点

​

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 更新日志
• 将 iOS SDK 从 2.2.6 更新至 2.2.7 — 详情请参阅 iOS SDK 更新日志

​

Android SDK 2.2.6

​

新增

• 生命周期事件遥测 — SDK 现在会在保留旧追踪链路的同时，新增第一方 init、bid request、load success、loss、impression、click、reward 和 error 遥测事件
• 崩溃遥测链路 — SDK 崩溃现在会在下次启动时通过旧崩溃追踪器和新的第一方崩溃遥测追踪器同时缓存并发送

​

变更

• 遥测中包含 placement 和 customData — Banner、插屏和激励广告的生命周期遥测现在会在事件发生时携带该广告实例对应的 placement 和 customData
• 崩溃缓存行为调整 — 即使未配置崩溃端点，崩溃遥测负载现在也会被缓存；端点是否存在只影响是否发送待处理负载
• 遥测端点命名统一 — 远程日志端点配置现在使用 sdkLogEndpointURL 命名，以与服务端协议保持一致

​

移除

• Session 初始化追踪 — 移除了旧的 session 端点和内部 session tracker 流程；SDK 初始化时不再发送旧的 session init 事件

​

修复

• 第一方遥测中的 SDK 错误可见性 — 竞价响应解析失败、适配器初始化失败和广告加载失败现在会记录到第一方遥测，而不再只出现在旧追踪链路中
• 崩溃追踪器相互隔离 — 一个崩溃追踪器失败后，不再阻止另一个追踪器缓存或发送其负载
• 发布版本不包含 Native Ads — 已发布的 2.2.6 版本明确排除了 commit f6d049327f249fa1728fbb9e754484f460e40fbd 中的 native ads 工作

​

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 更新日志
• 将 iOS SDK 从 2.2.4 更新至 2.2.6 — 详情请参阅 iOS SDK 更新日志

​

Android SDK 2.2.5

​

新增

• SDK 初始化遥测 — 通过 sdkInitEndpointURL 新增第一方 SDK 初始化事件跟踪
• 竞价请求遥测 — 通过 sdkBidReqEndpointURL 新增第一方竞价请求事件跟踪
• 展示中加载失败错误码 — 新增 LOAD_NOT_ALLOWED_WHILE_SHOWING，当同一个全屏广告实例正在展示时再次调用 load() 会明确失败

​

变更

• 全屏广告就绪状态改为由适配器提供 — 全屏广告是否就绪现在由底层广告网络适配器判断，而不再仅依赖 SDK 是否还持有缓存的全屏广告引用
• 过期全屏广告的重新加载处理 — FullscreenAdManager.load() 只有在适配器仍然报告广告可用时才会复用缓存广告；否则会销毁陈旧广告并重新发起加载
• 静态全屏广告过期机制 — 静态全屏广告现在会记录加载时间，并在一小时后不再报告为就绪

​

修复

• 内部跟踪事件丢失 — 修复适配器连续触发回调时，因代理协程作用域在事件发射完成前被取消而导致 impression、click、reward、error 内部跟踪丢失的问题
• 展示过程中错误接受新的加载请求 — 修复全屏广告在正在展示时仍接受 load() 的问题；现在会立即通过 onAdLoadFailed(..., LOAD_NOT_ALLOWED_WHILE_SHOWING) 失败
• 陈旧全屏广告仍被判定为可展示 — 修复底层广告网络 SDK 已使广告失效或过期后，全屏广告仍被报告为 ready 的问题
• Mintegral CMP 同意状态传递 — 修复 Mintegral 在由 CMP 管理 GDPR 同意时无法读取同意信息的问题；当未设置手动同意时，SDK 现在会调用 setConsentStatus(context) 让 Mintegral 从共享存储读取 TCF 字符串

​

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 设备上与会话追踪相关的崩溃

​

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 更新日志
• 将 iOS SDK 从 2.2.3 更新至 2.2.4 — 详情请参阅 iOS SDK 更新日志

​

Android SDK 2.2.4

​

新增

• 精细化无填充诊断 — 无填充错误消息现在包含每个网络的未出价原因，便于诊断填充率问题
• 改进竞价请求数据 — 竞价请求现在包含内容语言，以改善广告定向

​

变更

• 服务端驱动的位置控制 — 竞价请求中的位置坐标共享现在通过 CloudX 控制面板控制（账户级别）。发布商无需更改 SDK 代码。

​

修复

• ProGuard 兼容性 — 修复适配器模块的 consumer ProGuard 规则未正确应用的问题
• Mintegral 稳定性 — 修复 Mintegral 适配器在 Android 6.0 (API 23) 上的崩溃问题

​

iOS SDK 2.2.4

​

变更

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

​

Unity SDK 2.2.3

​

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

​

Android SDK 2.2.3

​

新增

• 通过指标管道新增远程日志采集，支持服务端控制过滤条件和采集限制
• 为 Unity Ads 适配器新增 GitHub Packages RC 工作流和 Maven Central 发布工作流支持

​

变更

• 将 Unity 适配器的产物/模块重命名为 adapter-unityads，并统一 SDK、构建配置和文档中的 Unity Ads 命名
• 将 CXLogger 重构为基于 handler 的架构，并简化了作用域日志实现
• 移除 demo app 对 SDK 内部 CXLogger 的依赖

​

修复

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

​

iOS SDK 2.2.3

​

新增

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

​

修复

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

​

Android SDK 2.2.2

​

新增

• 配置请求中包含适配器元数据
• 竞价令牌收集的指标追踪
• SDK 初始化后发送会话初始化事件

​

修复

• InMobi 竞价令牌获取现在在主线程上运行

​

Unity SDK 2.2.2

​

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）

​

iOS SDK 2.2.2

​

新增

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

​

修复

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

​

变更

• Mintegral SDK — 从 8.0.7 升级到 8.0.8

​

Android SDK 2.2.1

​

变更

• 为所有广告格式工厂的 Mintegral 适配器添加防御性空值检查和异常保护，并将 Mintegral SDK 从 17.0.61 升级至 17.0.91

​

修复

• 修复 BidRequestProvider.createBidRequest() 中的非局部返回问题，该问题导致适配器抛出异常时适配器扩展被静默跳过

​

Unity SDK 2.2.1

​

SDK 更新

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

​

Android SDK 2.2.0

​

新增

• 广告点击跟踪 — 用户点击广告时通知服务器
• 手动隐私 API — setHasUserConsent() 和 setDoNotSell()，用于自行管理用户同意的应用，自动转发至所有广告网络适配器
• Kotlin 协程支持 — 新增挂起函数 initialize() 重载，简化 Kotlin 集成
• 网络 SDK 崩溃报告 — 检测并报告来自广告网络 SDK 的崩溃
• 创意类型支持 — CloudX 渲染器新增创意类型
• 所有广告格式的适配器错误指标跟踪

​

变更

• CloudX 渲染器移入核心 SDK 模块
• 移除 appcompat 和 webkit 传递依赖，减小 SDK 体积
• 指标在临时失败（5xx、网络、超时）时保留并自动重试
• 将 Vungle SDK 从 7.6.1 升级至 7.7.1
• 将 InMobi SDK 从 11.1.0 升级至 11.1.1

​

修复

• 修复了地理位置数据从处理后的头部而非原始头部读取的问题
• 修复了 INVALID_APP_KEY 错误在非配置 HTTP 响应中错误出现的问题

​

Unity SDK 2.2.0

​

SDK 更新

• 将 Android SDK 从 2.0.1 更新至 2.2.0 — 详情请参阅 Android SDK 更新日志

​

React Native SDK 2.0.0

​

新增

• 完整的 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

​

Android SDK 2.0.1

​

变更

• 改进了内部事件持久化，采用更轻量的基于文件的存储方案，解决了 Unity Engine 2022.3 构建兼容性问题
• 将 Meta Audience Network SDK 从 6.21.0 降级至 6.20.0，以兼容 Unity Engine 2022.3

​

修复

• 修复了会话指标跟踪中罕见的并发访问问题
• 修复了使用 singleTask 启动模式的应用中 Meta 激励广告 Activity 被过早销毁的问题

​

Unity SDK 2.0.1

​

兼容性

• 新增对 Unity Engine 2022.3 LTS 的支持

​

SDK 更新

• 将 Android SDK 从 2.0.0 更新至 2.0.1 — 详情请参阅 Android SDK 更新日志

​

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

​

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

​

Android SDK 2.0.0

​

新增

• 激励视频广告 包括 CloudX.createRewarded()、CloudXRewardedAd、CloudXRewardedListener 和 CloudXReward
• InMobi 适配器 (SDK 11.1.0) 支持横幅、MREC、插屏和激励视频广告
• Vungle 激励视频广告 (SDK 7.6.1) 为现有 Vungle 适配器添加支持
• CloudX.isInitialized() 用于检查 SDK 初始化状态
• CloudX.getVersion() 用于获取 SDK 版本字符串
• 在 CloudXAdView 上添加 setPlacement() 和 setCustomData() 方法用于跟踪
• 在全屏广告上添加 show(activity, placement, customData) 重载用于跟踪
• 在 onInitialized() 回调中返回 CloudXSdkConfiguration
• 添加 CloudXAd.networkPlacement 属性用于网络特定的广告位 ID
• 新增错误代码：NETWORK_NO_CONNECTION、AD_ALREADY_SHOWING、DONT_KEEP_ACTIVITIES_ENABLED、AD_NOT_READY、INVALID_APP_KEY

​

破坏性变更

• 将 minSdk 从 21 提升到 23 (Android 6.0 Marshmallow)
• 将 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 参数 - 测试模式现在由服务器控制
• 将 show() 更改为 show(activity) 用于插屏和激励视频广告 - 现在需要 Activity 参数

​

变更

• Meta Audience Network SDK 从 6.17.0 更新到 6.21.0

​

修复

• 广告重新加载现在在 onAdHidden 和 onAdDisplayFailed 回调中正常工作
• 所有 load() 和 show() 调用现在保证在 UI 线程上回调

​

iOS SDK 2.0.0

​

新增

• 激励广告，使用 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（广告标识符）收集问题
• 修复国家/地理定向数据收集问题

​

Unity SDK 0.12.1

​

新功能

• 新增对 iOS 平台的支持

​

性能改进

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

​

SDK 更新

• 将 Android SDK 从 0.12.0 更新至 0.12.1

​

改进

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

​

Android SDK 0.12.1

​

修复

• 修复 Meta 适配器中由 getBidderToken() 阻塞主线程导致的 ANR

​

Unity SDK 0.12.0

​

Android SDK 0.12.0

​

破坏性变更

• 移除 CloudXError.effectiveMessage - 请直接使用 message
• 移除 setLoggingEnabled() - 使用 setMinLogLevel(CloudXLogLevel.NONE) 来禁用日志
• 移除 CloudXPrivacy 类 - 隐私现在通过 GPP/TCF 自动处理

​

变更

• 增强 GDPR 支持，包含 GPP Section 2 解析和供应商同意检查
• 简化 TCF 目的检查，仅需要目的 1 和 2（移除 3-4）
• 通过 GPP 添加 CCPA 支持，并提供传统 USPrivacy 回退
• 移除 COPPA 处理
• 添加 CloudXLogLevel.NONE 枚举值用于禁用日志

​

修复

• 修复初始化期间地理 API 失败处理

​

iOS SDK 1.3.0

​

新增

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

​

修复

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

​

变更

• CloudXCore 现在以动态框架分发 - 支持 SDK 问题的崩溃符号化

​

Android SDK 0.11.0

​

变更

• HTTP 客户端从 Ktor 3.0.3 迁移到 OkHttp 4.12.0
• 为所有广告格式添加 isDestroyed 保护

​

iOS SDK 1.2.1

​

新增

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

​

修复

• 更正 podspecs 中的 vendored_frameworks 路径

​

Android SDK 0.10.0

​

新增

• Vungle 适配器 (SDK 7.6.1) 支持横幅和插屏广告

​

变更

• 简化日志标签为 “CloudX” 以便更容易过滤 logcat
• 为公共 API 函数添加入口日志以便更好地调试
• SDK 初始化现在在未找到适配器时会提前失败并显示明确错误

​

修复

• 修复加载失败后横幅刷新停止的问题

​

Android SDK 0.9.0

​

新增

• 通过新的 CloudXAdRevenueListener 接口和 onAdRevenuePaid 回调实现广告收入追踪

​

变更

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

​

修复

• 修复广告生命周期管理中的内存泄漏
• 各种错误修复和稳定性改进

​

iOS SDK 1.2.0

​

🚀 首次正式发布

​

Android SDK 0.8.0

​

内部

• 验证发布自动化工作流程的测试版本

​

Android SDK 0.6.1

​

修复

• 修复发布脚本以更新中文 README (README.zh-CN.md) 版本号

​

Android SDK 0.6.0

​

新增

• 测试模式支持：在 CloudXInitializationParams 中添加 testMode 参数以在开发期间请求测试广告

​

Android SDK 0.5.0

​

修复

• 修复发布推广脚本以正确同步从发布分支到主分支的文件删除

​

Android SDK 0.4.0

​

新增

• CloudX Android SDK 初始 Alpha 版本
• 支持横幅 (320x50) 和 MREC (300x250) 广告格式
• 支持插屏全屏广告
• 具有智能广告聚合的实时竞价
• CloudX 和 Meta Audience Network 适配器支持
• GDPR、CCPA（通过 GPP）和 COPPA 隐私合规
• IAB TCF、USPrivacy 和 GPP 字符串支持
• 用于竞价优化的会话深度追踪
• 全面的广告生命周期回调和错误处理
• 可配置日志级别的调试日志