Integration

For CloudX dashboard mapping and Google-side setup, see the Google Waterfall bidder guide. 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

Podfile

pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.1'

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

Download CloudXGoogleWaterfallAdapter.xcframework.zip from Releases
Unzip and drag CloudXGoogleWaterfallAdapter.xcframework into your Xcode project
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:

Info.plist

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

Info.plist

<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. Include the full list to maximize attribution coverage.

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

Compatibility

Adapter version	Network SDK	Minimum CloudXCore
`13.6.0.1`	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

iOS SDK

Adapters

Installation

CocoaPods

Swift Package Manager

Manual

Info.plist Configuration

Google Application Identifier (Required)

SKAdNetwork IDs (Required for iOS 14.5+)

App Tracking Transparency (iOS 14+)

Project Configuration

Compatibility

Support

​Installation

​CocoaPods

​Swift Package Manager

​Manual

​Info.plist Configuration

​Google Application Identifier (Required)

​SKAdNetwork IDs (Required for iOS 14.5+)

​App Tracking Transparency (iOS 14+)

​Project Configuration

​Compatibility

​Support

Installation

CocoaPods

Swift Package Manager

Manual

Info.plist Configuration

Google Application Identifier (Required)

SKAdNetwork IDs (Required for iOS 14.5+)

App Tracking Transparency (iOS 14+)

Project Configuration

Compatibility

Support