Как интегрировать LY Ads Network с медиацией

В этом руководстве описывается, как использовать GMA Next-Gen SDK для загрузки и показа объявлений из рекламной сети LY Ads Network с помощью медиации, а также рассматривается каскадная интеграция. В ней рассказывается, как добавить рекламную сеть LY Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер рекламной сети LY Ads Network в приложение для Android.

Поддерживаемые интеграции и форматы объявлений

Адаптер медиации для LY Ads Network поддерживает следующие функции:

Требования

Прежде чем продолжить, убедитесь, что:

• Android API уровня 24 или более поздней версии.

• [Назначение ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер LY Ads Network версии 2.9.20241129.0 или более поздней (рекомендуется последняя версия).

• Последняя версия GMA Next-Gen SDK.

• Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе рекламной сети LY Ads

Зарегистрируйтесь и войдите в аккаунт LY Ads Network.

Как добавить приложение

Перейдите на вкладку App (Приложение) и нажмите кнопку New registration (Новая регистрация).

Заполните форму и нажмите Регистрация.

Запишите идентификатор приложения.

Как создать рекламное место

На вкладке Приложение выберите приложение, чтобы посмотреть подробные сведения о нем. В разделе Слот нажмите Добавить.

Заполните форму, чтобы получить информацию о месте размещения. В разделе Тип назначения ставок выберите Стандартный, чтобы настроить этот слот для медиации с каскадом, или Назначение ставок в SDK Google, чтобы настроить этот слот для назначения ставок. Заполнив форму, нажмите Создать.

Запишите идентификатор рекламного места.

После создания первого рекламного места нажмите Review (Проверить) на странице приложения, чтобы получить одобрение от LY Ads Network. Это может занять некоторое время. Если у вас возникнут вопросы, обратитесь к представителю рекламной сети LY.

Как создать ключ Reporting API

Перейдите на вкладку Управление ключами API для отчетов и нажмите кнопку Создать ключ API.

Заполните форму и нажмите Сохранить.

Запишите идентификатор ключа API и секретный ключ API.

Обновите файл app-ads.txt

Решение Authorized Sellers for Apps, или app-ads.txt, разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы.

Чтобы реализовать app-ads.txt для рекламной сети LY, ознакомьтесь с информацией о файле app-ads.txt.

Шаг 2. Настройте источник спроса LY Ads Network в интерфейсе Менеджера рекламы

Войдите в аккаунт Менеджера рекламы.

Как добавить LY Ads Network в раздел "Компании"

Включить передачу защищенных сигналов

Передавать защищенные сигналы в запросах ставок

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Как настроить назначение ставок в рекламной сети LY Ads

Как настроить сопоставление рекламных блоков

Шаг 3. Импортируйте SDK и адаптер рекламной сети LY Ads

Интеграция с Android Studio (рекомендуется)

В файле gradle на уровне приложения добавьте следующие зависимости и конфигурации:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Интеграция вручную

1. Скачайте последнюю версию LY Ads Network SDK и добавьте файл .aar в свой проект.

2. Перейдите к артефактам адаптера LY Ads Network в репозитории Google Maven. Выберите последнюю версию, скачайте файл .aar адаптера LY Ads Network и добавьте его в проект.

Шаг 4. Добавьте обязательный код

Для интеграции с рекламной сетью LY Ads Network не требуется дополнительный код.

Шаг 5. Протестируйте реализацию

Как включить тестовые объявления

Убедитесь, что вы зарегистрировали тестовое устройство в Менеджере рекламы.

Адаптер рекламной сети LY Ads Network содержит вспомогательный метод, позволяющий включить тестовый режим для рекламной сети LY Ads Network. Этот параметр необходимо задать до инициализации GMA Next-Gen SDK, чтобы данные корректно передавались в LY Ads Network SDK.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Проверьте тестовые объявления

Чтобы проверить, получаете ли вы тестовые объявления из сети LY Ads Network, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источник объявлений LY Ads Network.

Необязательные действия

Параметры для отдельных сетей

Адаптер рекламной сети LY Ads поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса LineExtras. Конструктор этого класса включает следующие параметры:

enableAdSound

boolean, чтобы задать состояние звука по умолчанию для баннеров, межстраничных объявлений и объявлений с вознаграждением.

Ниже приведен пример кода, в котором показано, как создать запрос объявления с этими параметрами.

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

Использование нативных объявлений

Отображение объявлений

Адаптер рекламной сети LY Ads заполняет следующие поля для NativeAd.

¹ LY Ads Network SDK не предоставляет объект значка приложения для нативных объявлений. Вместо этого адаптер рекламной сети LY Ads заполняет значок приложения прозрачным изображением.

Коды ошибок

Если адаптер не получает объявление от LY Ads Network, вы можете проверить основную ошибку в ответе на запрос объявления, используя ResponseInfo.getAdSourceResponses() в следующих классах:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Ниже приведены коды и сообщения, которые адаптер рекламной сети LY Ads Network выдает, когда не удается загрузить объявление.

Журнал изменений адаптера медиации LINE для Android

Версия 3.1.1.2

• Закрепите зависимость Kotlin адаптера на версии 1.9.0 (минимальная версия Kotlin, поддерживаемая GMA NextGen SDK).

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 25.4.0.
• Google Mobile Ads Next-Gen SDK версии 1.4.0.
• Версия SDK FiveAd 3.1.1.1.

Версия 3.1.1.1

• Maps AgeRestrictedTreatment в ChildDirectedTreatment API от Line.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 25.4.0.
• Google Mobile Ads Next-Gen SDK версии 1.2.1.
• Версия SDK FiveAd 3.1.1.1.

Версия 3.1.1.0

• Подтверждена совместимость с FiveAd SDK версии 3.1.1.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 25.2.0.
• Google Mobile Ads Next-Gen SDK версии 1.2.1.
• FiveAd SDK версии 3.1.1.0.

Версия 3.1.0.0

• Добавлено свойство для создания адаптера с зависимостью GMA Next-Gen SDK.
• Подтверждена совместимость с FiveAd SDK версии 3.1.0.0.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 25.1.0.
• Google Mobile Ads Next-Gen SDK версии 0.25.0-beta01.
• FiveAd SDK версии 3.1.0.0.

Версия 3.0.1.2

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 25.1.0.
• Версия SDK FiveAd 3.0.1.2.

Версия 3.0.1.1

• Показы нативных объявлений теперь перезаписываются FiveAd SDK при использовании Google Mobile Ads SDK версии 24.4.0 или более поздней.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.9.0.
• Версия SDK FiveAd 3.0.1.1.

Версия 3.0.1.0

• Добавлена поддержка пересылки параметра tagForUnderAgeOfConsent из Google Mobile Ads SDK в FiveAd SDK.
• Подтверждена совместимость с FiveAd SDK версии 3.0.1.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.9.0.
• FiveAd SDK версии 3.0.1.0.

Версия 3.0.0.0

• Подтверждена совместимость с FiveAd SDK версии 3.0.0.0.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 24.9.0.
• FiveAd SDK версии 3.0.0.0.

Версия 2.9.20251028.0

• Подтверждена совместимость с FiveAd SDK версии 2.9.20251028.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.7.0.
• FiveAd SDK версии 2.9.20251028.0

Версия 2.9.20250924.1

• Удалены ссылки на Context на уровне класса. Помогает снизить вероятность утечки памяти.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.7.0.
• FiveAd SDK версии 2.9.20250924.1.

Версия 2.9.20250924.0

• Подтверждена совместимость с FiveAd SDK версии 2.9.20250924.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.6.0.
• FiveAd SDK версии 2.9.20250924.0

Версия 2.9.20250718.0

• Подтверждена совместимость с версией 2.9.20250718 SDK FiveAd.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.3.0.
• FiveAd SDK версии 2.9.20250718.0.

Версия 2.9.20250519.0

• Подтверждена совместимость с FiveAd SDK версии 2.9.20250519.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 24.3.0.
• Версия FiveAd SDK 2.9.20250519.0.

Версия 2.9.20250317.1

• Исправлены размеры загрузки баннеров для объявлений с назначением ставок с помощью нового FiveAd API.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.1.0.
• Версия FiveAd SDK 2.9.20250317.0

Версия 2.9.20250317.0

• Подтверждена совместимость с версией 2.9.20250317 SDK FiveAd.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 24.1.0.
• Версия FiveAd SDK 2.9.20250317.0

Версия 2.9.20250110.1

• Минимальный уровень Android API теперь 23.
• Минимальная версия Google Mobile Ads SDK теперь 24.0.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 24.0.0.
• FiveAd SDK версии 2.9.20250110.0

Версия 2.9.20250110.0

• Удален устаревший класс UnifiedNativeAdMapper. Вместо него используется NativeAdMapper.
• Исправлен процесс сбора сигналов.
• Исправлен процесс инициализации для межстраничных объявлений и объявлений с вознаграждением в каскаде.
• Подтверждена совместимость с FiveAd SDK версии 2.9.20250110.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 23.6.0.
• FiveAd SDK версии 2.9.20250110.0

Версия 2.9.20241129.0

• Добавлена поддержка назначения ставок для баннеров, межстраничных, нативных объявлений и объявлений с вознаграждением.
• Подтверждена совместимость с версией 2.9.20241129 SDK FiveAd.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 23.5.0.
• FiveAd SDK версии 2.9.20241129.0

Версия 2.8.20240827.0

• Подтверждена совместимость с FiveAd SDK версии 2.8.20240827.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 23.3.0.
• FiveAd SDK версии 2.8.20240827.0

Версия 2.8.20240808.0

• Подтверждена совместимость с FiveAd SDK версии 2.8.20240808.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 23.2.0.
• FiveAd SDK версии 2.8.20240808.0

Версия 2.8.20240722.0

• Подтверждена совместимость с FiveAd SDK версии 2.8.20240722.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 23.2.0.
• FiveAd SDK версии 2.8.20240722.0

Версия 2.7.20240515.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20240515.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 23.1.0.
• FiveAd SDK версии 2.7.20240515.0

Версия 2.7.20240214.1

• Минимальная версия Google Mobile Ads SDK теперь 23.0.0.
• Подтверждена совместимость с версией 2.7.20240214 SDK FiveAd.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 23.0.0.
• Версия SDK FiveAd 2.7.20240214.0.

Версия 2.7.20240214.0

• Подтверждена совместимость с версией 2.7.20240214 SDK FiveAd.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 22.6.0.
• Версия SDK FiveAd 2.7.20240214.0.

Версия 2.7.20240126.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20240126.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 22.6.0.
• FiveAd SDK версии 2.7.20240126.0.

Версия 2.7.20240112.0

• Удалена устаревшая функция FiveAdViewEventListener. Вместо нее используются функции FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener и FiveAdNativeEventListener.
• Подтверждена совместимость с FiveAd SDK версии 2.7.20240112.
• Минимальная требуемая версия Google Mobile Ads SDK изменена на 22.6.0.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 22.6.0.
• Версия SDK FiveAd 2.7.20240112.

Версия 2.6.20230607.1

• Добавлен класс LineExtras, позволяющий издателям задавать настройки звука по умолчанию для баннеров, межстраничных объявлений и объявлений с вознаграждением.
• Минимальная требуемая версия Google Mobile Ads SDK изменена на 22.4.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 22.4.0.
• FiveAd SDK версии 2.6.20230607.

Версия 2.6.20230607.0

• Первый выпуск.
• Добавлена поддержка баннеров, межстраничных объявлений, объявлений с вознаграждением и нативных объявлений.
• Подтверждена совместимость с FiveAd SDK версии 2.6.20230607.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 22.1.0.
• Версия SDK FiveAd 2.6.20230607.