---
metadata:
- name: generator
content: Diplodoc Platform v5.57.3
alternate:
- https://boost.yandex.com/doc/en/ad-monetization/dev/android/quick-start-mm.md
- https://boost.yandex.com/doc/ru/ad-monetization/dev/android/quick-start-mm.md
- href: en/ad-monetization/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://boost.yandex.com/doc/en/llms.txt
# Integration Yandex Mediation
{% note warning %}
Be sure to update to the latest adapter versions ([Yandex Mediation](https://boost.yandex.com/doc/en/ad-monetization/dev/android/list-network.md) and [adapters for third-party mediation networks](https://boost.yandex.com/doc/en/ad-monetization/dev/android/third-party-mediation.md)). Otherwise, errors from improper adapter integration might occur, preventing the ad from being served.
{% endnote %}
[Yandex Mediation](https://boost.yandex.com/doc/en/ad-monetization/monetization/yandex-mediation/index.md) is a platform that automatically selects ads from a variety of ad networks using ML algorithms, which helps you maximize your revenue. All settings are preconfigured, so you can start using it immediately without having to set up each network individually.
If you've been using the Yandex Mobile Ads SDK with a single Yandex network, migrating to Yandex Mediation requires no code changes. You only need to preset the sections of third-party advertising networks' web interfaces.
## Prerequisites {#prolog}
To prepare your app, follow the steps described in the next sections.
### App requirements {#requirements}
- Use Android Studio 2021 or higher.
- Use Android Gradle Plugin version 8.7.0 or higher.
- Check that your app's build file uses the following values:
- minSdkVersion 21 or higher.
- compileSdkVersion 35 or higher.
- To load any type of ad, Android version 4.1 or higher is required.
- Video ads are only served for devices with Android 5 or higher.
- If you use the [AppMetrica SDK](https://appmetrica.yandex.com) in your app, make sure that you have version 8.3.0 or higher (within major version 7) installed.
### Set up the app in your Boost account {#yan}
Register your app as a Boost app by following these steps:
1. [Log in](https://boost.yandex.com/) for the Boost.
2. [Register](https://boost.yandex.com/) your app in the Boost.
## Integration {#integration}
To connect individual adapters, enable the Yandex Ads SDK, then follow the specific instructions for each adapter:
1. [Set up mediation](https://boost.yandex.com/doc/en/ad-monetization/monetization/yandex-mediation/setup.md) in the Boost interface.
2. Add a YandexMobileAds dependency to the build.gradle file of your app module:
```groovy
dependencies {
...
implementation 'com.yandex.android:mobileads:x.x.x' // add supported version
// Add dependencies on Yandex Mediation adapters.
}
```
3. Add Java 8 support to the build.gradle file of your app module:
```groovy
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
```
4. Add the following code to the build.gradle file in your app's module:
```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/"
}
// BidMachine
maven {
url 'https://artifactory.bidmachine.io/bidmachine'
}
// 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/"
}
```
5. Set up permission to use an advertising ID (for apps using SDK versions older than 4.5.0).
{% include notitle [ad-id](../_includes/ad-id.md) %}
{% note warning %}
Lack of permission and access to the ID may impact your revenue, because your app may serve less relevant ads.
{% endnote %}
6. Connect the required [adapters](https://boost.yandex.com/doc/en/ad-monetization/dev/android/list-network.md) separately using the appropriate packages.
{% included (../_includes/ad-id.md) %}
# Ad ID
{% cut "How to set up permission to use the ad ID" %}
Advertising IDs are unique IDs provided by Google Play services. They're used to serve ads to users who consent to personalized ads. Users can opt out of personalized ads or reset the ID in the settings. In this case, ad networks can't use it to serve relevant ads.
If your app uses a Yandex Mobile Ads SDK version lower than 4.5.0, add the com.google.android.gms.permission.AD_ID permission to your app's AndroidManifest.xml file:
```xml
```
Starting with version 4.5.0, Yandex Mobile Ads SDK adds the com.google.android.gms.permission.AD_ID permission by default. This means you don't need to specify it in your app's main manifest. With this permission, you can use the advertising ID to serve more relevant ads from ad networks.
You can remove the permission, if necessary. For example, you may need to do this if a policy, such as the Families Policy, doesn't allow using the ID to serve ads.
To prevent the permission from being added to your app's main manifest, add the following to the AndroidManifest.xml file:
```xml
```
{% endcut %}
{% endincluded %}