集成

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.10.0'

pod install --repo-update

Swift Package Manager

将适配器软件包添加到项目：

软件包 URL：https://github.com/cloudx-io/cloudx-ios-swift-package-adapter-digitalturbine.git
精确软件包版本：8041000.0.0
Product：CloudXDigitalTurbineAdapter

该软件包会安装 CloudX Core 和 Digital Turbine 依赖项。在应用 target 的 Other Linker Flags 中添加 $(inherited) -ObjC。

手动安装

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

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.10.0`	Fyber Marketplace SDK `8.4.10`	`3.5.0`
`8.4.8.0`	Fyber Marketplace SDK `8.4.8`	`3.5.0`
`8.4.7.0`	Fyber Marketplace SDK `8.4.7`	`3.5.0`
`8.4.6.0`	Fyber Marketplace SDK `8.4.6`	`3.5.0`

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

已知问题

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

iOS 模拟器上不下发 Digital Turbine

**影响范围：**所有 CloudXDigitalTurbineAdapter 版本，仅限 iOS 模拟器。真机不受影响。

**现象：**Fyber Marketplace SDK 在模拟器上会间歇性崩溃，表现为解析其自身某个泛型类型的 Swift 类型元数据时出现 EXC_BAD_ACCESS。为保证模拟器可用，CloudX 在向模拟器会话下发的 bidder 列表中省略 Digital Turbine，因此该适配器在模拟器上不会初始化，Digital Turbine 无法在模拟器上投放广告。服务端竞价仍可能为该会话征询 Digital Turbine 的出价，但该出价无法渲染。控制台会在 Digital Turbine bidder 配置中显示同样的提示。

**状态：**请在 iOS 真机上测试 Digital Turbine。我们已向 Digital Turbine 报告该崩溃；在认证修复后的 Fyber 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