Google AdMob (ex. AdMob) медиация

Примечание

Следуйте этому руководству, если вы уже используете Google AdMob mediation и хотите добавить Boost как пользовательское событие.

Если вы хотите управлять внешними рекламными сетями через интерфейс Boost, используйте Yandex Mobile Mediation.

Подключение к Boost доступно через Google AdMob (ex. AdMob) медиацию. Для добавления Boost в Google AdMob (ex. AdMob) медиацию выполните следующие шаги:

  1. Интегрируйте Google AdMob (ex. AdMob) медиацию.
  2. Подключите адаптер для Yandex Mobile Ads SDK.
  3. Создайте AdUnitId для выбранного типа рекламы в интерфейсе Boost.
  4. Добавьте Boost в веб-интерфейсе Google AdMob (ex. AdMob).
  5. Синхронизируйте настройки рекламного блока в обоих веб-интерфейсах.

Подключение адаптера для Yandex Mobile Ads SDK

Для подключения Boost в 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"

Добавление Boost в веб-интерфейсе Google AdMob (ex. AdMob) медиации

Для каждого рекламного места в Google AdMob (ex. AdMob) медиации (AdMob AdUnitId) создайте рекламный блок в интерфейсе Boost (Ad Unit ID).

Затем добавьте Boost в веб-интерфейсе Google AdMob (ex. AdMob) медиации:

1. Создайте рекламный блок Google AdMob (ex. AdMob)

  1. Перейдите в раздел вашего приложения.
  2. Создайте ad unit для выбранного формата рекламы, настройте параметры рекламного места, например, название рекламного места.
  3. После создания рекламного блока сохраните его идентификатор.
Скриншоты из интерфейса Google AdMob (ex. AdMob)

2. Создайте рекламный блок Yandex

Инструкция по созданию рекламного блока в интерфейсе Boost.

3. Настройте Google AdMob (ex. AdMob) медиацию

  1. В веб-интерфейсе Google AdMob (ex. AdMob) перейдите в раздел Mediation → Mediation groups и нажмите кнопку Create mediation group.

  2. Выберите платформу.

  3. Задайте параметры медиационной группы (название, регион и прочее) и перейдите к добавлению в нее рекламного места.

  4. Выберите ваше приложение, созданный Ad Unit и добавьте его. Добавленный Ad Unit должен отобразиться в разделе Ad Units.

  5. Boost может быть добавлена в Google AdMob (ex. AdMob) медиацию только как пользовательское событие. Перейдите к добавлению пользовательского события (кнопка Add Custom Event). Настройку кастомного события необходимо выполнить/повторить для каждого adUnitId, заведенного в интерфейсе Boost.

  6. Настройте пользовательское событие обращения в Boost: задайте имя события и eCPM порог.

    Важно

    Значение и валюта eCPM порога должны совпадать с порогом, указанным в интерфейсе Boost для данного рекламного места.

    Если для рекламного места в интерфейсе Boost выбрана стратегия Максимальный доход и порог не задан, в AdMob укажите ожидаемый eCPM или eCPM за прошлые периоды. AdMob использует это значение для позиционирования пользовательского события в водопаде.

  7. Настройте сопоставление пользовательского события с адаптером Boost:

    • задайте имя сопоставления;
    • имя класса адаптера, соответствующее выбранному формату рекламы;
    • параметры события.

    У каждого формата рекламы есть соответствующий ему класс адаптера Boost:

    • com.admob.mobileads.YandexBanner для рекламы типа баннер;
    • com.admob.mobileads.YandexInterstitial для interstitial;
    • com.admob.mobileads.YandexRewarded для rewarded;
    • com.admob.mobileads.YandexNative для нативной рекламы.

    В поле Parameter задайте настройки пользовательского события в формате JSON. Обязательным параметром является установка Ad Unit ID для выбранного рекламного места в формате {"adUnitId": "R-M-XXXXXX-X"}.

    Важно

    Имя класса адаптера Boost и JSON-ключ adUnitId чувствительны к регистру. Убедитесь, что они написаны правильно, иначе пользовательское событие может не загрузить рекламу.

    Для нативной рекламы при подключении к Boost через Google AdMob (ex. AdMob) необходимо передавать store/storeView, так как через него передается обязательный компонент domain. Если storeView не зарегистрирован или не отображается, показ может не засчитываться. Для компактных layout-ов можно использовать отдельный однострочный TextView без подписи, зарегистрированный как storeView.

  8. Сохраните изменения.

Скриншоты из интерфейса Google AdMob (ex. AdMob)

4. Протестируйте интеграцию

Перед публикацией приложения убедитесь, что пользовательское событие настроено корректно:

  1. Проверьте, что имя класса адаптера указано точно так, как на шаге 7.
  2. Убедитесь, что параметр пользовательского события имеет правильный JSON-формат: {"adUnitId": "R-M-XXXXXX-X"}.
  3. Протестируйте интеграцию с помощью демонстрационных рекламных блоков или тестовых плейсментов.
  4. Проверьте логи приложения и Debug Panel на наличие ошибок инициализации адаптера и загрузки рекламы.