Skip to main content

CloudX Unity Ads Adapter

Unity Ads adapter for CloudX iOS SDK. Supports banner, interstitial, and rewarded video ads with header bidding.

Requirements

  • iOS 13.0+
  • Xcode 16.0+
  • Swift 6.0+

Installation

CocoaPods

Podfile
pod 'CloudXUnityAdsAdapter'
pod install --repo-update

Manual

  1. Download CloudXUnityAdsAdapter-v{version}.xcframework.zip from Releases
  2. Unzip and drag CloudXUnityAdsAdapter.xcframework into your Xcode project
  3. Add Unity Ads SDK 4.17.0+ manually

Info.plist Configuration

SKAdNetwork IDs (Required for iOS 14.5+)

Unity Ads’ primary SKAdNetwork ID is required for attribution:
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>
Unity publishes a full list of SKAdNetwork IDs in their documentation. Adding these additional IDs improves attribution accuracy across Unity’s demand partners.

App Tracking Transparency (iOS 14+)

Info.plist
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

Project Configuration

Linker Flags: Add -ObjC to Other Linker Flags in Build Settings. This is required because CloudXCore is a dynamic framework and Objective-C categories must be loaded at runtime. Deployment Target: Ensure your project’s minimum deployment target is iOS 13.0 or higher.

Unity Ads SDK Frameworks

The Unity Ads adapter requires several system frameworks. When using CocoaPods, these are configured automatically. For manual integration, ensure the following frameworks are linked:
  • Foundation, UIKit, WebKit, AVFoundation, CoreMedia
  • AudioToolbox, CFNetwork, CoreGraphics, CoreTelephony
  • SystemConfiguration, StoreKit

Support

For support, contact mobile@cloudx.io