> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 集成

> CloudX Android SDK 的 Google Mobile Ads waterfall 适配器。支持 AdMob waterfall Banner 和 MREC 广告位。

Google Ad Manager 支持预留给未来版本。

## 安装

<CodeGroup>
  ```kotlin Kotlin DSL theme={null}
  dependencies {
      implementation("io.cloudx:adapter-googlewaterfall:25.1.0.0")
  }
  ```

  ```groovy Groovy theme={null}
  dependencies {
      implementation 'io.cloudx:adapter-googlewaterfall:25.1.0.0'
  }
  ```
</CodeGroup>

## Android Manifest

Google Mobile Ads SDK 要求在应用 manifest 中配置 AdMob app ID：

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

如果缺少该 metadata，适配器会在调用 `MobileAds.initialize` 之前初始化失败。

## 展示级收入数据

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

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

## 兼容性

| 适配器版本      | 广告网络 SDK                       | 最低 CloudX SDK |
| ---------- | ------------------------------ | ------------- |
| `25.1.0.1` | Google Mobile Ads SDK `25.1.0` | `4.1.0`       |

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