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) and MREC (300×250) ad formats. Interstitial and Rewarded are not supported by this adapter.

​
Installation

​
CocoaPods

Podfile
pod 'CloudXGoogleWaterfallAdapter', '~> 3.4.5'

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 12.14.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.)

​
Support

For support, contact mobile@cloudx.io