集成

CloudX Android SDK 的 AdMob/GAM estimated 适配器。可在 Google Mobile Ads SDK 或 GMA Next-Gen SDK 上投放 AdMob waterfall 需求，并在 Google Mobile Ads SDK 上投放 Google Ad Manager 需求，支持 Banner、MREC、Interstitial、Rewarded、Native 和 App Open 广告位。

该 Google 适配器同时投放 AdMob estimated 和 Google Ad Manager estimated 两种需求 — 分别对应 AdMob waterfall 和 Google Ad Manager。在 Android 上提供两个适配器制品，分别对应 Google 广告 SDK 的两个代次。请根据您的应用所集成的 Google SDK 选择对应的制品。

您获得的是哪种 Google 需求

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

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

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

自 adapter-googlewaterfall 25.2.0.2 起支持 Google Ad Manager 需求。Ad Manager 广告位通过您已集成的同一个 Google Mobile Ads SDK 投放，无需引入额外依赖。CloudX 会根据服务端配置按广告位进行选择，您无需在应用中做任何启用操作。adapter-admob 不投放 Ad Manager 需求，会跳过此类广告位。

您使用的是哪个 SDK？

您必须且仅能集成下列两个制品之一。两个 Google SDK 代次包含相互冲突的类，无法在同一应用中共存。

• Google Mobile Ads SDK（play-services-ads 25.x）— 标准的 AdMob SDK。使用 io.cloudx:adapter-googlewaterfall。
• GMA Next-Gen SDK（com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk 1.3.0）— Google 以 Kotlin 优先的替代 SDK。使用 io.cloudx:adapter-admob。

两个制品的广告格式完全对等：Banner、MREC、Interstitial、Rewarded、App Open 和 Native。控制台映射、广告位下发以及收入语义完全一致。

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

安装

dependencies {
    implementation("io.cloudx:adapter-googlewaterfall:25.2.0.1")
}

dependencies {
    implementation 'io.cloudx:adapter-googlewaterfall:25.2.0.1'
}

dependencies {
    implementation("io.cloudx:adapter-admob:1.3.0.0")
}

dependencies {
    implementation 'io.cloudx:adapter-admob:1.3.0.0'
}

Android Manifest

两种方式的发布商设置相同。Google SDK 要求在应用 manifest 中配置 AdMob app ID：

<application>
  <meta-data
      android:name="com.google.android.gms.ads.APPLICATION_ID"
      android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" />
</application>

如果缺少该 metadata，适配器会在 Google SDK 初始化之前初始化失败。

展示级收入数据

请在 AdMob 控制台中启用展示级广告收入，以便通过 CloudX 报告已投放展示及其 paid value：

AdMob console -> Account -> Account info -> Impression-level ad revenue。

该控制台设置适用于 AdMob estimated 需求。Google Ad Manager estimated 需求的展示级收入通过您的 Ad Manager 侧设置上报。

兼容性

Google Mobile Ads SDK — adapter-googlewaterfall

Next-Gen SDK — adapter-admob

要求 minSdk 24。

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