集成

CloudX iOS SDK 的 AdMob/GAM estimated 适配器。投放 AdMob waterfall 和 Google Ad Manager 需求的 Banner、MREC、Interstitial、Rewarded、Native 和 App Open 广告位。

该 Google 适配器同时投放 AdMob estimated 和 Google Ad Manager estimated 两种需求 — 分别对应 AdMob waterfall 和 Google Ad Manager。CloudX 控制台映射和 Google 侧设置请使用为您的 CloudX 账号提供的设置详情。本页仅说明 iOS 特定的集成细节。

有关 Dashboard 配置，请参阅Google Waterfall 发布商设置指南。

该适配器支持横幅 (320×50)、中矩形 (300×250)、插屏、激励视频、原生广告和 App Open 广告格式，两种需求来源均适用。

您获得的是哪种 Google 需求

该适配器投放两种独立的 Google 需求：

• AdMob estimated — AdMob waterfall 需求。
• Google Ad Manager estimated — Google Ad Manager 需求。

运行哪一种由控制台决定，而非代码决定。您需要在 CloudX 控制台中按广告位启用相应的广告需求来源；无需单独的制品，无需额外依赖，也无需修改应用侧代码。两种需求来源可在同一应用中同时运行，各自拥有独立的映射和 CPM 目标，也可以在同一场竞价中同时出价。

Google Ad Manager 的广告单元 ID 格式为 /NNNNNNN/placement/name，与 AdMob 的普通广告单元 ID 不同。

安装

CocoaPods

pod 'CloudXGoogleWaterfallAdapter', '~> 13.6.0.3'

pod install --repo-update

Swift Package Manager

在项目中同时添加 CloudX 包和 Google Mobile Ads 包，然后添加 CloudXGoogleWaterfallAdapter 产品：

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

手动安装

1. 从 Releases 下载 CloudXGoogleWaterfallAdapter.xcframework.zip
2. 解压并将 CloudXGoogleWaterfallAdapter.xcframework 拖入您的 Xcode 项目
3. 手动添加 Google Mobile Ads SDK（Google-Mobile-Ads-SDK 13.6.0）。

Info.plist 配置

Google 应用标识符（必需）

Google Mobile Ads SDK 需要在 Info.plist 中配置您的 AdMob 应用 ID。否则应用将在启动时崩溃：

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-XXXXXXXXXXXXXXXX~YYYYYYYYYY</string>

请将该值替换为您在 AdMob 控制台中的应用 ID。

SKAdNetwork IDs（iOS 14.5+ 必需）

添加 Google 的 SKAdNetwork 标识符，以便 Google 归因安装。Google 的主标识符为：

<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <!-- 添加完整的 Google Mobile Ads SKAdNetwork 列表 -->
</array>

Google 在其 Google Mobile Ads 文档 中发布了完整且最新的 SKAdNetwork 标识符列表。请添加完整列表以最大化归因覆盖率。

App Tracking Transparency（iOS 14+）

<key>NSUserTrackingUsageDescription</key>
<string>此标识符将用于向您投放个性化广告。</string>

项目配置

链接器标志： 在 Build Settings 中将 -ObjC 添加到 Other Linker Flags。（CocoaPods 和 SPM 集成会自动设置此项。）

兼容性

当服务端下发的 CloudX 配置包含 AdMob estimated 或 Google Ad Manager estimated 需求时，SDK 会自动发现该适配器。无需手动注册适配器。

支持

如需支持，请联系 support@cloudx.io