Подключение Mobile Ads SDK

Внимание.

Это архивная версия документации. Актуальная документация по всем платформам находится здесь.

  1. Инициализация Mobile Ads SDK
Примечание.
  1. Для загрузки любого вида рекламы необходима версия Android 4.1 и выше.
  2. Видеореклама подбирается только на устройства с версией Android 5.0 и выше.

Есть несколько способов подключения:

Подключить все доступные адаптеры можно автоматически с помощью общей библиотеки медиации YandexMobileAdsMediation.

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

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

    Для каждого адаптера самая свежая совместимая версия будет выбрана автоматически.

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

    android {
    
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }
  3. Добавьте код в 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"
    }
  4. Настройте разрешение на использование рекламного идентификатора.

    В Yandex Mobile Ads SDK, начиная с версии 4.5.0, появилось новое разрешение com.google.android.gms.permission.AD_ID. Оно прописано в файле AndroidManifest.xml библиотеки. Поэтому указывать его дополнительно в основном манифесте приложения не нужно. Разрешение позволяет использовать рекламный идентификатор для подбора релевантной рекламы от рекламных сетей.

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

    Чтобы разрешение не попало в основной манифест приложения, добавьте в файл AndroidManifest.xml строку:

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

Инициализация Mobile Ads SDK

Перед загрузкой рекламы инициализируйте библиотеку с помощью метода initialize(). Инициализация ускорит загрузку объявлений.

Примечание.

Это необходимо делать во время каждого нового запуска приложения. Поэтому рекомендуется добавить код инициализации в метод onCreate класса Application.

Пример инициализации:
public class YandexApplication extends Application {

    private static final String YANDEX_MOBILE_ADS_TAG = "YandexMobileAds";

    @Override
    public void onCreate() {
        super.onCreate();

        MobileAds.initialize(this, new InitializationListener() {
            @Override
            public void onInitializationCompleted() {
                Log.d(YANDEX_MOBILE_ADS_TAG, "SDK initialized");
            }
        });
    }
}

Ознакомьтесь с примерами использования SDK.