---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ads.yandex.com/helpcenter/en/dev/android/quick-start-mm.md
  - https://ads.yandex.com/helpcenter/pt/dev/android/quick-start-mm.md
  - https://ads.yandex.com/helpcenter/ru/dev/android/quick-start-mm.md
  - https://ads.yandex.com/helpcenter/zh/dev/android/quick-start-mm.md
  - href: zh/dev/android/quick-start-mm.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/zh/llms.txt

# 集成 Yandex 聚合

{% note warning %}

请确保将您使用的 [Yandex 聚合](https://ads.yandex.com/helpcenter/zh/dev/android/list-network.md) 适配器和 [第三方聚合网络适配器](https://ads.yandex.com/helpcenter/zh/dev/android/third-party-mediation.md) 更新到最新版本。旧版本可能会导致适配器集成错误，从而导致您的广告无法投放。

{% endnote %}

[Yandex 聚合](https://ads.yandex.com/helpcenter/zh/monetization/yandex-mediation/index.md) 是一个使用机器学习算法从各种网络自动选择广告的平台，以最大限度地提高您的收入。所有设置都是即插即用的，这意味着无需单独调试每个网络。

如果您之前仅在一个 Yandex 网络中使用 Yandex Mobile Ads SDK，则无需更改代码中的任何内容即可切换到 Yandex 聚合。您只需在外部广告网络的网页界面中预先配置单元即可。

## 初步设置 {#prolog}

要准备您的应用，请按照下一节中的步骤操作。

### 应用要求 {#requirements}

- 使用 Android Studio 2021 或更高版本。
- 使用 Android Gradle 插件 8.7.0 或更高版本。
- 确保您的应用的构建文件使用以下值：
   - minSdkVersion 21 或更高版本。
   - compileSdkVersion 35 或更高版本。
- 要加载任何类型的广告，您需要 Android 4.1 或更高版本。
- 仅针对采用 Android 5 或更高版本的设备选择视频广告。
- 如果您在应用程序中使用 [AppMetrica SDK](https://appmetrica.yandex.com)，请确保已安装 8.3.0 及以上版本（仅限于一个主要版本）。

### 在您的 Yandex Advertising Network 账户中设置应用程序 {#yan}

<!-- source: zh/dev/_includes/reg.md -->
以下是在 Yandex Advertising Network 中注册您的应用的方法：

1. 在 Yandex Advertising Network 中 [登录](https://partner.yandex.ru/)  或 [登录](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27) 您的账户。
2. 在 Yandex Advertising Network 中 [注册](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27) 您的应用。
<!-- endsource: zh/dev/_includes/reg.md -->

## 集成

要添加单独的适配器，请按照以下说明启用 Yandex Ads SDK 和相关适配器：

1. 在 Yandex Advertising Network 界面中 [设置聚合](https://ads.yandex.com/helpcenter/zh/monetization/yandex-mediation/setup.md)。
2. 将 YandexMobileAds 依赖项添加到应用模块中的 build.gradle 文件中：

      ```groovy
      dependencies {
         ...
         implementation 'com.yandex.android:mobileads:x.x.x' // 添加支持的版本

         // 添加对 Yandex 聚合适配器的依赖项。

      }
      ```

3. 将对 Java 8 的支持添加到应用模块中的 build.gradle 文件：

      ```groovy
      android {

          compileOptions {
              sourceCompatibility JavaVersion.VERSION_1_8
              targetCompatibility JavaVersion.VERSION_1_8
          }
      }
      ```
4. 将以下代码添加到应用模块中的 build.gradle 文件中：

      <!-- source: zh/dev/_includes/build-gradle-code.md -->
      ```groovy
      // IronSource
      maven {
             url 'https://android-sdk.is.com/'
      }

      // Pangle
      maven {
             url 'https://artifact.bytedance.com/repository/pangle'
      }

      // Tapjoy
      maven {
             url "https://sdk.tapjoy.com/"
      }

      // Mintegral
      maven {
             url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
      }

      // Chartboost
      maven {
             url "https://cboost.jfrog.io/artifactory/chartboost-ads/"
      }

      // AppNext
      maven {
             url "https://dl.appnext.com/"
      }
      ```
      <!-- endsource: zh/dev/_includes/build-gradle-code.md -->

5. 设置使用广告 ID 的权限（适用于运行 4.5.0 以下 SDK 版本的应用）。

      <!-- source: zh/dev/_includes/ad-id.md -->
      {% cut "如何设置使用广告 ID 的权限" %}

      广告 ID 是 Google Play 服务提供的唯一标识符，用于向选择个性化广告的用户展示广告。用户可以选择退出广告个性化设置或在设置中重置其 ID。在这种情况下，广告网络将无法使用该 ID 为用户选择相关广告。

      如果您的应用运行低于 4.5 的 Yandex Mobile Ads SDK 版本，请将 com.google.android.gms.permission.AD_ID 添加到 AndroidManifest.xml 文件中：
      ```xml
      <manifest>
          <application>
          <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
              <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
          </application>
      </manifest>
      ```

      从版本 4.5.0 开始，Yandex Mobile Ads SDK 默认添加 com.google.android.gms.permission.AD_ID。因此，您不必在应用程序的主清单中指定它。该权限允许您使用广告 ID 从广告网络中选择更相关的广告。

      如果需要，您可以删除该权限。例如，如果政策不允许使用 ID 来选择广告，例如家庭政策。

      要防止将该权限添加到应用程序的主清单中，请将以下代码添加到 AndroidManifest.xml 中：
      ```xml
      <manifest>
          <application>
              <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
          </application>
      </manifest>
      ```
      {% endcut %}
      <!-- endsource: zh/dev/_includes/ad-id.md -->

      {% note warning %}

      缺乏此权限和对 ID 的访问权限可能会降低广告的相关性，从而降低您的收入。

      {% endnote %}

6. 使用适当的包一一添加适用的 [适配器](https://ads.yandex.com/helpcenter/zh/dev/android/list-network.md)。