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

В этом руководстве рассказывается, как использовать Google Mobile Ads SDK (Legacy) для загрузки и показа объявлений из рекламной сети LY Ads с помощью медиации, включая интеграцию каскада. В ней рассказывается, как добавить рекламную сеть LY Ads Network в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер рекламной сети LY Ads Network в приложение для Android.

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

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

Требования

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

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

• Последняя версия Google Mobile Ads SDK (Legacy).

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

Шаг 1. Настройте конфигурации в интерфейсе LY Ads Network

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

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

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

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

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

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

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

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

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

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

Как создать ключ 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 в интерфейсе Менеджера рекламы

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

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

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

Настраиваемые вручную интеграции

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

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

Шаг 4. Добавьте необходимый код

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

Шаг 5. Проверьте реализацию

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

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

Адаптер рекламной сети LY Ads Network содержит вспомогательный метод, позволяющий включить тестовый режим для рекламной сети LY Ads Network. Этот параметр необходимо задать до инициализации Google Mobile Ads SDK (Legacy), чтобы данные корректно передавались в 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.

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

Коды ошибок

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

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.
• FiveAd SDK версии 3.1.1.1.

Версия 3.1.1.1

• Сопоставляется с API ChildDirectedTreatment в Line.AgeRestrictedTreatment

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

• 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.
• FiveAd SDK версии 3.0.1.2.

Версия 3.0.1.1

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

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

• Google Mobile Ads SDK версии 24.9.0.
• FiveAd SDK версии 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.
• Версия SDK FiveAd 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

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

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

• 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.
• Версия SDK FiveAd 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

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

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

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

Версия 2.9.20250317.0

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

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

• 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.
• Версия SDK FiveAd 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.
• FiveAd SDK версии 2.7.20240214.0.

Версия 2.7.20240214.0

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

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

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

Версия 2.7.20240126.0

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

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

• 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.
• FiveAd SDK версии 2.7.20240112.

Версия 2.6.20230607.1

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

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

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

Версия 2.6.20230607.0

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

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

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