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

Внимание.

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

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

Библиотека Yandex Mobile Ads предоставляется в формате AAR. Чтобы подключить Mobile Ads SDK:

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

    dependencies {
        ...
        implementation 'com.yandex.android:mobileads:5.10.0'
    }
  2. Обновите зависимость от Koltin Gradle Plugin в корневом build.gradle файле вашего проекта:

    dependencies {
        ...
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.10")
    }
  3. Добавьте поддержку Java 8 в build.gradle файл модуля вашего приложения:

    android {
    
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }
  4. Настройте разрешение на использование рекламного идентификатора.

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

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