> ## 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

> Google Waterfall adapter for CloudX iOS SDK. Supports Banner, MREC, Interstitial, Rewarded, Native, and App Open.

For CloudX dashboard mapping and Google-side setup, see the [Google Waterfall bidder guide](/en/networks/google-waterfall). This page covers iOS-specific integration details only.

The Google Waterfall adapter supports **Banner (320×50)**, **MREC (300×250)**, **Interstitial**, **Rewarded**, **Native**, and **App Open** ad formats.

## Installation

### CocoaPods

```ruby Podfile theme={null}
pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.0'
```

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

### Swift Package Manager

Add both the CloudX package and the Google Mobile Ads package to your project, then add the `CloudXGoogleWaterfallAdapter` product:

* CloudX: `https://github.com/cloudx-io/cloudx-ios`
* Google Mobile Ads: `https://github.com/googleads/swift-package-manager-google-mobile-ads`

### Manual

1. Download `CloudXGoogleWaterfallAdapter.xcframework.zip` from [Releases](https://github.com/cloudx-io/cloudx-ios/releases)
2. Unzip and drag `CloudXGoogleWaterfallAdapter.xcframework` into your Xcode project
3. Add the Google Mobile Ads SDK (`Google-Mobile-Ads-SDK 13.6.0`) manually.

## Info.plist Configuration

### Google Application Identifier (Required)

The Google Mobile Ads SDK requires your AdMob app ID in Info.plist. Without it, the app will crash at launch:

```xml Info.plist theme={null}
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>
```

Replace the value with your own AdMob app ID from the AdMob console.

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

Add Google's SKAdNetwork identifiers so Google can attribute installs. The primary Google identifier is:

```xml Info.plist theme={null}
<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <!-- Add the full Google Mobile Ads SKAdNetwork list -->
</array>
```

Google publishes the complete, up-to-date SKAdNetwork identifier list in its [Google Mobile Ads documentation](https://developers.google.com/admob/ios/quick-start). Include the full list to maximize attribution coverage.

### 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. (The CocoaPods and SPM integrations set this automatically.)

## Compatibility

| Adapter version | Network SDK                     | Minimum CloudXCore |
| --------------- | ------------------------------- | ------------------ |
| `13.6.0.0`      | Google Mobile Ads SDK `13.6.0`  | `3.5.0`            |
| `12.14.0.0`     | Google Mobile Ads SDK `12.14.0` | `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)