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

Медиация Яндекса — платформа, которая автоматически подбирает рекламу из множества сетей на основе алгоритмов ML. Это позволяет максимизировать доход. Все настройки работают «из коробки» — отлаживать каждую сеть отдельно не нужно.

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

Дополнительно об интеграции медиации Яндекса смотрите в видео:

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

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

Требования к приложению

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

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

Зарегистрируйте свое приложение как приложение Рекламной сети Яндекса, выполнив следующие действия:

1. Войдите или зарегистрируйте аккаунт в Рекламной сети Яндекса.
2. Зарегистрируйте свое приложение в Рекламной сети Яндекса.

Подключение

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

1. Настройте медиацию в интерфейсе Рекламной сети Яндекса.

2. Добавьте зависимость от YandexMobileAds в build.gradle файл модуля вашего приложения:

   dependencies {
       ...
       implementation 'com.yandex.android:mobileads:x.x.x' // add supported version
   
       // Add dependencies on Yandex Mediation adapters.
   
   }
   

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

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

4. Добавьте код в build.gradle файл модуля вашего приложения:

   // 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. Настройте разрешение на использование рекламного идентификатора (для приложений, использующих sdk ниже версии 4.5.0).

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

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

   Если ваше приложение использует версию Yandex Mobile Ads SDK ниже 4.5.0, необходимо добавить разрешение com.google.android.gms.permission.AD_ID в AndroidManifest.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 следующий код:

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

   Важно

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

6. Подключите необходимые адаптеры отдельно с помощью соответствующих пакетов.