Integrating Yandex mediation

You can automatically enable all available adapters using the yandex-mobileads-mediation general mediation package.

1. Set up mediation in the Yandex Partner interface.

2. Add the YandexMobileAdsMediation dependency to the build.gradle file in your app's module:

   dependencies {
          ...
          implementation 'com.yandex.android:mobileads-mediation:7.7.0.0'
   }
   

   For each adapter, the latest compatible version is selected automatically.

3. Add Java 8 support to the build.gradle file in your app's module:

   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:

   // 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/"
   }
   

5. Set up permission to use the ad ID (optional starting with version 4.5.0).

   How to set up permission to use the ad ID

   The ad ID is a unique identifier provided by Google Play services for displaying ads to users who opt in to personalized ads. Users can opt out of ad personalization or reset their ID in the settings. In this case, advertising networks won't be able to use the ID to select relevant ads for the user.

   If your app runs a Yandex Mobile Ads SDK version below 4.5, add com.google.android.gms.permission.AD_ID to the AndroidManifest.xml file:

   <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>
   

   As of version 4.5.0, the Yandex Mobile Ads SDK adds com.google.android.gms.permission.AD_ID by default. Because of this, you don't have to specify it in the application's main manifest. The permission allows you to use an ad ID to select more relevant ads from advertising networks.

   You can delete the permission if necessary. For example, if a policy does not allow the use of an ID for ad selection, such as the Families Policy.

   To keep the permission from being added to the application's main manifest, add the following code to AndroidManifest.xml:

   <manifest>
       <application>
           <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
       </application>
   </manifest>
   

   Warning

   Lack of this permission and access to the ID may reduce the relevance of ads and, as a result, your income.

6. Additional setting for the Google AdMob (ex. AdMob) network.

   Add your Google AdMob (ex. AdMob) ID to the AndroidManifest.xml file created for your app using the <meta-data> tag named com.google.android.gms.ads.APPLICATION_ID (here's how to find your AdMob ID).

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