> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration

> Unity Ads adapter for CloudX iOS SDK. Supports Banner, MREC, Interstitial, and Rewarded.

For CloudX dashboard mapping and Unity Ads-side ID setup, see the [Unity Ads bidder guide](/en/networks/unity-ads). This page covers iOS-specific integration details only.

## Installation

### CocoaPods

```ruby Podfile theme={null}
pod 'CloudXUnityAdsAdapter', '~> 4.19.0.0'
```

```bash theme={null}
pod install --repo-update
```

### Manual

1. Download `CloudXUnityAdsAdapter.xcframework.zip` from [Releases](https://github.com/cloudx-io/cloudx-ios/releases)
2. Unzip and drag `CloudXUnityAdsAdapter.xcframework` into your Xcode project
3. Add `UnityAds` (`= 4.19.0`) manually.

<Warning>
  UnityAds 4.19.0 is built with a newer Swift toolchain. Building with Xcode 16.x can fail to link with `Undefined symbol: _swift_coroFrameAlloc` — build with Xcode 26 or later.
</Warning>

## Info.plist Configuration

### SKAdNetwork IDs (Required for iOS 14.5+)

Unity Ads' primary SKAdNetwork ID is required for attribution:

```xml Info.plist theme={null}
<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>bvpn9ufa9b.skadnetwork</string>
    </dict>
</array>
```

<Note>
  Unity publishes a full list of SKAdNetwork IDs in their documentation. Adding these additional IDs improves attribution accuracy across Unity's demand partners.
</Note>

### App Tracking Transparency (iOS 14+)

```xml Info.plist theme={null}
<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

## Compatibility

| Adapter version | Network SDK       | Minimum CloudXCore |
| --------------- | ----------------- | ------------------ |
| `4.19.0.0`      | UnityAds `4.19.0` | `3.5.0`            |
| `4.18.1.0`      | UnityAds `4.18.1` | `3.5.0`            |

The adapter is discovered automatically when your server-provisioned CloudX configuration includes this network's demand. No manual adapter registration is required.

## Support

For support, contact [mobile@cloudx.io](mailto:mobile@cloudx.io)