跳转到主要内容

更新日志

CloudX iOS SDK 的所有重要更改都将记录在此文件中。 格式基于 Keep a Changelog, 本项目遵循 语义化版本

[1.3.0] - 2025-12-14

新增

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

修复

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

变更

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

[1.2.1] - 2025-12-04

新增

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

修复

  • 更正 podspecs 中的 vendored_frameworks 路径

[1.2.0] - 2025-11-26

🚀 首次正式发布

CloudX iOS SDK 是一款全面的移动广告解决方案,为 iOS 应用提供程序化广告功能。

功能

广告格式

  • 横幅广告 (320×50) - 标准横幅广告
  • MREC 广告 (300×250) - 中等矩形广告
  • 插屏广告 - 全屏广告

核心功能

  • 服务端头部竞价 - 与多个需求源的实时程序化竞价
  • 统一竞价 - 单一 SDK 管理所有集成需求合作伙伴的竞价
  • 隐私合规 - 内置支持 GDPR、CCPA 和应用追踪透明度 (ATT)
  • 全面分析 - 会话追踪、展示指标和收入报告

开发者体验

  • 简单集成 - 初始化一次,使用单个方法调用创建广告
  • 基于代理的回调 - 清晰的广告加载、展示和错误生命周期事件
  • 测试模式 - 内置开发和 QA 测试模式
  • 灵活日志 - 可配置的日志详细程度用于调试

架构

  • 静态 XCFramework 分发 - 快速应用启动时间,无 dSYM 警告
  • 模块化适配器系统 - 仅添加您需要的需求合作伙伴
  • iOS 14.0+ - 现代 iOS 支持,兼容 Swift 和 Objective-C

组件

组件描述
CloudXCore具有程序化广告引擎的核心 SDK
CloudXMetaAdapterMeta Audience Network 集成
CloudXVungleAdapterVungle/Liftoff 头部竞价集成
CloudXRendererCloudX 需求的创意渲染引擎

安装

Podfile
platform :ios, '14.0'

target 'YourApp' do
  use_frameworks!
  
  pod 'CloudXCore'
  pod 'CloudXMetaAdapter'      # 可选
  pod 'CloudXVungleAdapter'    # 可选
  pod 'CloudXRenderer'         # 用于测试广告
end

快速开始

// 初始化 SDK
[[CloudXCore shared] initializeSDKWithAppKey:@"YOUR_APP_KEY"
                                    testMode:NO
                                  completion:^(BOOL success, CLXError *error) {
    if (success) {
        NSLog(@"CloudX SDK 已初始化!");
    }
}];

// 创建并加载横幅广告
CLXBannerAdView *banner = [[CloudXCore shared] createBannerWithPlacement:@"PLACEMENT_ID"
                                                           viewController:self
                                                                 delegate:self
                                                                     tmax:nil];
[self.view addSubview:banner];
[banner load];

文档

有关完整文档,请参阅集成指南