Integration

AdMob/GAM estimated adapter for CloudX iOS SDK. Serves AdMob waterfall and Google Ad Manager demand for Banner, MREC, Interstitial, Rewarded, Native, and App Open placements.

The Google adapter serves both AdMob estimated and Google Ad Manager estimated demand — AdMob waterfall and Google Ad Manager, respectively. Use the setup details provided for your CloudX account for dashboard mapping and Google-side setup. This page covers iOS-specific integration details only.

For dashboard configuration, see the Google Waterfall publisher setup guide.

The adapter supports Banner (320×50), MREC (300×250), Interstitial, Rewarded, Native, and App Open ad formats for both demand sources.

Which Google demand you get

The adapter serves two independent Google demand sources:

• AdMob estimated — AdMob waterfall demand.
• Google Ad Manager estimated — Google Ad Manager demand.

Which one runs is a dashboard decision, not a code one. You enable the ad source per placement in the CloudX dashboard; there is no separate artifact, no extra dependency, and no app-side change. Both sources may run in the same app, each with its own mapping and CPM target, and both may bid in the same auction.

Ad Manager ad unit ids take the form /NNNNNNN/placement/name, unlike AdMob’s plain ad unit id.

Installation

CocoaPods

pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.3'

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:

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

<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+)

<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

The adapter is discovered automatically when your server-provisioned CloudX configuration includes AdMob estimated or Google Ad Manager estimated demand. No manual adapter registration is required.

Support

For support, contact support@cloudx.io