集成

CloudX iOS SDK 的 Unity Ads 适配器。支持 Banner、MREC、Interstitial 和 Rewarded。

有关 CloudX 控制台映射和 Unity Ads 侧 ID 设置,请参阅 Unity Ads 竞价方指南。本页仅说明 iOS 特定的集成细节。

安装

CocoaPods

Podfile
pod 'CloudXUnityAdsAdapter', '~> 4.19.0.0'
pod install --repo-update

手动安装

  1. Releases 下载 CloudXUnityAdsAdapter.xcframework.zip
  2. 解压并将 CloudXUnityAdsAdapter.xcframework 拖入您的 Xcode 项目
  3. 手动添加 UnityAds= 4.19.0)。

Info.plist 配置

SKAdNetwork IDs(iOS 14.5+ 必需)

Unity Ads 的主要 SKAdNetwork ID 用于归因:

Info.plist
<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>bvpn9ufa9b.skadnetwork</string>
    </dict>
</array>

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

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

项目配置

链接器标志: 在 Build Settings 的 Other Linker Flags 中添加 -ObjC。这是必需的,因为 CloudXCore 是动态框架,Objective-C 类别必须在运行时加载。

部署目标: 确保您项目的最低部署目标为 iOS 13.0 或更高版本。

Unity Ads SDK 框架

Unity Ads 适配器需要多个系统框架。使用 CocoaPods 时,这些会自动配置。手动集成时,请确保链接以下框架:

  • Foundation、UIKit、WebKit、AVFoundation、CoreMedia
  • AudioToolbox、CFNetwork、CoreGraphics、CoreTelephony
  • SystemConfiguration、StoreKit

兼容性

适配器版本广告网络 SDK最低 CloudXCore
4.19.0.0UnityAds 4.19.03.5.0
4.18.1.0UnityAds 4.18.13.5.0
4.16.6.0UnityAds 4.16.63.5.0

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

支持

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