Integration Yandex Mediation

• Use Android Studio 2021 or higher.
• Check that your app's build file uses the following values:
  • minSdkVersion 21 or higher.
  • compileSdkVersion 31 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.

Permission to use the advertising 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.

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:

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

COPPA setup

You can set up these policies using the AndroidManifest.file or right before initializing the SDK manually.

If you've chosen automatic initialization, add the following code to the AndroidManifest.xml file to notify the Yandex Mobile Ads SDK when the app user is a child:

<manifest>
    <application>
        <!-- Disable the use of child's personal data for app monetization.  -->
        <meta-data
          android:name="@string/yandex_mobileads_age_restricted_user"
          android:value="true" />
    </application>
</manifest>

To connect individual adapters, enable the Yandex Ads SDK, then follow the specific instructions for each adapter:

1. Set up mediation in the Boost interface.

2. Add the YandexMobileAds dependency to the androidMain.dependencies block in the build.gradle.kts file at the app level:

   androidMain.dependencies {
       ...
       implementation("com.yandex.android:mobileads:x.x.x") // Specify the supported version
   
       // Adapter dependencies Yandex Mediation.
   }
   

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

   android {
   
       compileOptions {
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
   }
   

4. Add this code to the build.gradle file in your app's Android 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/"
   }
   
   // 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).

   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:

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

   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:

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

   Warning

   Lack of permission and access to the ID may impact your revenue, because your app may serve less relevant ads.

6. Connect the required adapters separately using the appropriate packages.