Google AdMob (ex. AdMob) медиация
Примечание
Следуйте этому руководству, если вы уже используете Google AdMob mediation и хотите добавить Рекламную сеть Яндекса как пользовательское событие.
Если вы хотите управлять внешними рекламными сетями через интерфейс Рекламной сети Яндекса, используйте Yandex Mobile Mediation.
Подключение к Рекламной сети Яндекса доступно через Google AdMob (ex. AdMob) медиацию. Для добавления Рекламной сети Яндекса в Google AdMob (ex. AdMob) медиацию выполните следующие шаги:
- Интегрируйте Google AdMob (ex. AdMob) медиацию.
- Подключите адаптер для Yandex Mobile Ads SDK.
- Создайте AdUnitId для выбранного типа рекламы в интерфейсе Рекламной сети Яндекса.
- Добавьте Рекламную сеть Яндекса в веб-интерфейсе Google AdMob (ex. AdMob).
- Синхронизируйте настройки рекламного блока в обоих веб-интерфейсах.
Подключение адаптера для Yandex Mobile Ads SDK
Для подключения Рекламной сети Яндекса в Google AdMob (ex. AdMob) медиацию добавьте в build.gradle файл модуля вашего проекта зависимость от адаптера:
dependencies {
...
implementation 'com.yandex.ads.adapter:admob-mobileads:8.0.0.0'
}
Чтобы вручную передавать из кода приложения в Yandex Mobile Ads SDK значения GDPR (user consent) и COPPA (age-restricted user), дополнительно подключите Yandex Mobile Ads SDK. Добавьте в блок dependencies:
implementation "com.yandex.android:mobileads:8.0.0.0"
Добавление Рекламной сети Яндекса в веб-интерфейсе Google AdMob (ex. AdMob) медиации
Для каждого рекламного места в Google AdMob (ex. AdMob) медиации (AdMob AdUnitId) создайте рекламный блок в интерфейсе Рекламной сети Яндекса (Yandex Ad Unit ID).
Затем добавьте Рекламную сеть Яндекса в веб-интерфейсе Google AdMob (ex. AdMob) медиации:
1. Создайте рекламный блок Google AdMob (ex. AdMob)
- Перейдите в раздел вашего приложения.
- Создайте ad unit для выбранного формата рекламы, настройте параметры рекламного места, например, название рекламного места.
- После создания рекламного блока сохраните его идентификатор.
Скриншоты из интерфейса Google AdMob (ex. AdMob)
2. Создайте рекламный блок Yandex
Инструкция по созданию рекламного блока в интерфейсе Рекламной сети Яндекса.
3. Настройте Google AdMob (ex. AdMob) медиацию
-
В веб-интерфейсе Google AdMob (ex. AdMob) перейдите в раздел Mediation → Mediation groups и нажмите кнопку Create mediation group.
-
Выберите платформу.
-
Задайте параметры медиационной группы (название, регион и прочее) и перейдите к добавлению в нее рекламного места.
-
Выберите ваше приложение, созданный Ad Unit и добавьте его. Добавленный Ad Unit должен отобразиться в разделе Ad Units.
-
Рекламная сеть Яндекса может быть добавлена в Google AdMob (ex. AdMob) медиацию только как пользовательское событие. Перейдите к добавлению пользовательского события (кнопка Add Custom Event). Настройку кастомного события необходимо выполнить/повторить для каждого adUnitId, заведенного в интерфейсе Рекламной сети Яндекса.
-
Настройте пользовательское событие обращения в Рекламную сеть Яндекса: задайте имя события и eCPM порог.
Важно
Значение и валюта eCPM порога должны совпадать с порогом, указанным в интерфейсе Рекламной сети Яндекса для данного рекламного места.
Если для рекламного места в интерфейсе Рекламной сети Яндекса выбрана стратегия Максимальный доход и порог не задан, в AdMob укажите ожидаемый eCPM или eCPM за прошлые периоды. AdMob использует это значение для позиционирования пользовательского события в водопаде.
-
Настройте сопоставление пользовательского события с адаптером Яндекс:
- задайте имя сопоставления;
- имя класса адаптера, соответствующее выбранному формату рекламы;
- параметры события.
У каждого формата рекламы есть соответствующий ему класс адаптера Яндекс:
com.admob.mobileads.YandexBannerдля рекламы типа баннер;com.admob.mobileads.YandexInterstitialдля interstitial;com.admob.mobileads.YandexRewardedдля rewarded;com.admob.mobileads.YandexNativeдля нативной рекламы.
В поле Parameter задайте настройки пользовательского события в формате JSON. Обязательным параметром является установка Yandex Ad Unit ID для выбранного рекламного места в формате
{"adUnitId": "R-M-XXXXXX-X"}.Важно
Имя класса адаптера Яндекс и JSON-ключ
adUnitIdчувствительны к регистру. Убедитесь, что они написаны правильно, иначе пользовательское событие может не загрузить рекламу.Для нативной рекламы при подключении к Рекламной сети Яндекса через Google AdMob (ex. AdMob) необходимо передавать
store/storeView, так как через него передается обязательный компонентdomain. ЕслиstoreViewне зарегистрирован или не отображается, показ может не засчитываться. Для компактных layout-ов можно использовать отдельный однострочныйTextViewбез подписи, зарегистрированный какstoreView. -
Сохраните изменения.
Скриншоты из интерфейса Google AdMob (ex. AdMob)
4. Протестируйте интеграцию
Перед публикацией приложения убедитесь, что пользовательское событие настроено корректно:
- Проверьте, что имя класса адаптера указано точно так, как на шаге 7.
- Убедитесь, что параметр пользовательского события имеет правильный JSON-формат:
{"adUnitId": "R-M-XXXXXX-X"}. - Протестируйте интеграцию с помощью демонстрационных рекламных блоков или тестовых плейсментов.
- Проверьте логи приложения и Debug Panel на наличие ошибок инициализации адаптера и загрузки рекламы.