Подключение Mobile Ads SDK
Это архивная версия документации. Актуальная документация по всем платформам находится здесь.
- Для загрузки любого вида рекламы необходима версия Android 4.1 и выше.
- Видеореклама подбирается только на устройства с версией Android 5.0 и выше.
Библиотека Yandex Mobile Ads предоставляется в формате AAR. Чтобы подключить Mobile Ads SDK:
Добавьте зависимость от Yandex Mobile Ads в build.gradle файл модуля вашего приложения:
dependencies { ... implementation 'com.yandex.android:mobileads:5.10.0' }
Обновите зависимость от Koltin Gradle Plugin в корневом build.gradle файле вашего проекта:
dependencies { ... classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.10") }
Добавьте поддержку Java 8 в build.gradle файл модуля вашего приложения:
android { compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } }
Настройте разрешение на использование рекламного идентификатора.
Рекламный идентификатор – уникальный идентификатор сервисов 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"/>
Если ваше приложение использует версию Yandex Mobile Ads SDK ниже 4.5.0 и нет ограничений на использование рекламного идентификатора (например, Families Policy), добавьте разрешение в основной манифест приложения AndroidManifest.xml:
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
Отсутствие разрешения и доступа к идентификатору может снизить релевантность рекламы и, как следствие, ваш доход.
Инициализация 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.