Skip to main content
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.0'

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
  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:
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 versionNetwork SDKMinimum CloudXCore
13.6.0.0Google Mobile Ads SDK 13.6.03.5.0
12.14.0.0Google Mobile Ads SDK 12.14.03.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