集成

CloudX iOS SDK 的 Digital Turbine(Fyber Marketplace)适配器。支持 Banner、MREC、Interstitial、Rewarded 和 Native。

CloudX 控制台映射和 Digital Turbine 侧 ID 配置请参阅 Digital Turbine 竞价方指南。本页仅介绍 iOS 特有的集成细节。

安装

CocoaPods

Podfile
pod 'CloudXDigitalTurbineAdapter', '~> 8.4.8.0'
pod install --repo-update

手动安装

  1. Releases 下载 CloudXDigitalTurbineAdapter.xcframework.zip
  2. 解压并将 CloudXDigitalTurbineAdapter.xcframework 拖入 Xcode 项目。
  3. 手动添加 Fyber_Marketplace_SDK (= 8.4.8)。

Info.plist 配置

SKAdNetwork IDs(iOS 14+ 必需)

包含 Digital Turbine 为您的集成提供的 SKAdNetwork ID。最新的 SKAdNetworkItems 列表请参阅当前的 Fyber_Marketplace_SDK 文档。

应用追踪透明度(iOS 14+)

Info.plist
<key>NSUserTrackingUsageDescription</key>
<string>此标识符将用于向您投放个性化广告。</string>

项目配置

链接器标志: 在 Build Settings 的 Other Linker Flags 中添加 -ObjC

原生广告

适配器不会直接公开主图素材:ad.nativeAd.mainImage 不会被填充。媒体内容(图片或视频)通过适配器提供的媒体视图渲染,CloudX 会将其附加到通过视图绑定器的 mediaContentViewTag 绑定的容器。请按原生广告的说明绑定可见的媒体容器。

兼容性

适配器版本广告网络 SDK最低 CloudXCore
8.4.8.0Fyber Marketplace SDK 8.4.83.5.0
8.4.7.0Fyber Marketplace SDK 8.4.73.5.0
8.4.6.0Fyber Marketplace SDK 8.4.63.5.0

当服务端下发的 CloudX 配置包含该广告网络需求时,SDK 会自动发现该适配器。无需手动注册适配器。

已知问题

本节仅列出当前存在的问题。已解决的条目会移入适配器更新日志。

Fyber Marketplace SDK 8.4.8 可能导致 Objective-C 应用在 SDK 初始化后崩溃

影响范围:CloudXDigitalTurbineAdapter 8.4.8.0(Fyber Marketplace SDK 8.4.8),主 target 为 Objective-C 的应用,或以动态框架方式集成 CloudXCore 的应用。Swift 应用尚未复现。

**现象:**调用 [CloudXCore initializeSDKWithAppKey:…] 几秒后出现 EXC_BAD_ACCESS,发生在队列 com.Fyber.SDK.Marketplace.core.config 上、Fyber SDK 解析远程配置的过程中,且每次启动都会复现。

**临时解决方案:**固定使用上一条适配器版本线,它基于 Fyber Marketplace SDK 8.4.7,不受影响——将 Podfile 中 CloudXDigitalTurbineAdapter 的版本设为 ~> 8.4.7.0。运行 pod install --repo-update,并确认 Podfile.lock 中显示 Fyber_Marketplace_SDK (8.4.7)。我们已向 Digital Turbine 报告该问题;在认证修复后的 Fyber SDK 之后,本条目将移入更新日志。

支持

如需支持,请联系 support@cloudx.io