---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
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
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/ru/llms.txt


[//]: # (Эта страница переводится также на бразильский португальский — pt-BR)

<!--
Используется в Boost: boost/ru/ad-monetization/dev/android
-->

# Интеграция Медиации Яндекса

{% note warning %}

Обязательно обновите версии используемых адаптеров на актуальные ([Медиация Яндекса](https://ads.yandex.com/helpcenter/ru/dev/android/list-network.md) и [адаптеры для сторонних медиационных сетей](https://ads.yandex.com/helpcenter/ru/dev/android/third-party-mediation.md)). Иначе возможны ошибки неправильной интеграции адаптеров и реклама не будет показана.


{% endnote %}

[Медиация Яндекса](https://ads.yandex.com/helpcenter/ru/monetization/yandex-mediation/index.md) — платформа, которая автоматически подбирает рекламу из множества сетей на основе алгоритмов ML. Это позволяет максимизировать доход. Все настройки работают «из коробки» — отлаживать каждую сеть отдельно не нужно.

Если вы раньше использовали Yandex Mobile Ads SDK только с одной сетью Яндекса, то для перехода на Медиацию не придется ничего менять в коде. Предварительно нужно только настроить блоки в веб-интерфейсе внешних рекламных сетей.


## Предварительная настройка {#prolog}

Чтобы подготовить приложение, выполните действия, описанные в следующих разделах.

### Требования к приложению {#requirements}

- Используйте Android Studio 2021 или выше.
- Используйте Android Gradle Plugin версии 8.7.0 и выше.
- Убедитесь, что в файле сборки вашего приложения используются следующие значения:
   - minSdkVersion 21 или выше;
   - compileSdkVersion 35 или выше.
- Для загрузки любого вида рекламы необходима версия Android 4.1 и выше.
- Видеореклама подбирается только на устройства с версией Android 5 и выше.
- Если в своем приложении вы используете [AppMetrica SDK](https://appmetrica.yandex.ru), убедитесь, что у вас установлена версия 8.3.0 и выше (в пределах 7-й мажорной версии).

### Настройте приложение в своем аккаунте в Рекламной сети Яндекса {#yan}

<!-- source: ru/dev/_includes/reg.md -->
Зарегистрируйте свое приложение как приложение Рекламной сети Яндекса, выполнив следующие действия:

1. [Войдите](https://partner.yandex.ru/) или [зарегистрируйте](https://passport.yandex.ru/auth/list?origin=rsy_ligth_in&retpath=https%3A%2F%2Fpartner.yandex.ru%2Fform%2F?roles%5B%5D=27) аккаунт в Рекламной сети Яндекса.
2. [Зарегистрируйте](https://passport.yandex.ru/auth/list?origin=rsy_ligth_in&retpath=https%3A%2F%2Fpartner.yandex.ru%2Fform%2F?roles%5B%5D=27) свое приложение в Рекламной сети Яндекса.
<!-- endsource: ru/dev/_includes/reg.md -->

## Подключение

Чтобы подключить адаптеры по отдельности, подключите Yandex Ads SDK и необходимые адаптеры по инструкциям к этим адаптерам:

1. [Настройте медиацию](https://ads.yandex.com/helpcenter/ru/monetization/yandex-mediation/setup.md) в интерфейсе Рекламной сети Яндекса.
2. Добавьте зависимость от YandexMobileAds в build.gradle файл модуля вашего приложения:
     ```groovy
     dependencies {
         ...
         implementation 'com.yandex.android:mobileads:x.x.x' // add supported version

         // Add dependencies on Yandex Mediation adapters.

     }
     ```

3. Добавьте поддержку Java 8 в build.gradle файл модуля вашего приложения:
     ```groovy
     android {

         compileOptions {
             sourceCompatibility JavaVersion.VERSION_1_8
             targetCompatibility JavaVersion.VERSION_1_8
         }
     }
     ```
4. Добавьте код в build.gradle файл модуля вашего приложения:

     <!-- source: ru/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: ru/dev/_includes/build-gradle-code.md -->

5. Настройте разрешение на использование рекламного идентификатора (для приложений, использующих sdk ниже версии 4.5.0).

     {% include notitle [ad-id](../_includes/ad-id.md) %}

     {% note warning %}

      Отсутствие разрешения и доступа к идентификатору может снизить релевантность рекламы и, как следствие, ваш доход.

     {% endnote %}

6. Подключите необходимые [адаптеры](https://ads.yandex.com/helpcenter/ru/dev/android/list-network.md) отдельно с помощью соответствующих пакетов.

{% included (../_includes/ad-id.md) %}
# Рекламный идентификатор

{% cut "Как настроить разрешение на использование рекламного идентификатора" %}

  Рекламный идентификатор – уникальный идентификатор сервисов Google Play для показа рекламы пользователям, которые согласны видеть персонализированные объявления. Пользователь может отключить персонализацию рекламы или сбросить идентификатор в настройках. В таком случае рекламные сети не смогут использовать его для подбора релевантной рекламы.

  Если ваше приложение использует версию Yandex Mobile Ads SDK ниже 4.5.0, необходимо добавить разрешение 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 по умолчанию. Поэтому указывать его дополнительно в основном манифесте приложения не нужно. Разрешение позволяет использовать рекламный идентификатор для подбора более релевантной рекламы от рекламных сетей.

  При необходимости, вы можете удалить разрешение. Например, если какие-то политики, такие как Families Policy, не позволяют использовать идентификатор для подбора рекламы.

  Чтобы разрешение не попало в основной манифест приложения, добавьте в файл AndroidManifest.xml следующий код:
  ```xml
  <manifest>
      <application>
          <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
      </application>
  </manifest>
  ```
{% endcut %}

{% endincluded %}