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

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

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

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

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

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

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

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

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

Регистрация нового участника

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

Новая регистрационная форма

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

Сведения о регистрации

Создайте рекламное место

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

Добавить слот

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

Форма добавления рекламного места

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

Сведения о рекламном месте

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

Запросить проверку

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

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

Вкладка "Ключ Reporting API"

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

Форма для ключа Reporting API

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

Форма для ключа Reporting 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 в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Добавьте LY Ads Network в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Перейдите на вкладку Медиация. Если вы хотите изменить существующую группу медиации, нажмите на ее название и перейдите к разделу Добавьте LY Ads Network в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат объявления и платформу, а затем нажмите Продолжить.

Укажите название группы медиации и выберите местоположения для таргетинга. Затем установите для статуса группы медиации значение Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими рекламными блоками AdMob. Затем нажмите Готово.

Вы увидите карточку с выбранными рекламными блоками:

Как добавить LY Ads Network в качестве источника объявлений

Ставки


В разделе Источники объявлений найдите карточку Назначение ставок и выберите Добавить источник объявлений. Затем выберите LY Ads Network.

Нажмите Как подписать партнерское соглашение и установите партнерскую связь с назначением ставок с LY Ads Network.



Нажмите Подтвердить и согласиться, а затем – Продолжить.



Если у вас уже есть сопоставление для рекламной сети LY Ads, вы можете выбрать его. В противном случае нажмите Добавить сопоставление.



Затем введите идентификатор приложения и идентификатор рекламного места, полученные в предыдущем разделе. Затем нажмите Готово.



Водопад


На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите рекламную сеть LY Ads и включите переключатель Оптимизировать. Чтобы настроить оптимизацию источника объявлений для рекламной сети LY Ads, введите идентификатор ключа API и секретный ключ API, полученные в предыдущем разделе. Затем введите значение эффективной цены за тысячу показов для рекламной сети LY Ads Network и нажмите Продолжить.




Если у вас уже есть сопоставление для рекламной сети LY Ads, вы можете выбрать его. В противном случае нажмите Добавить сопоставление.



Затем введите идентификатор приложения и идентификатор рекламного места, полученные в предыдущем разделе. Затем нажмите Готово.


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

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

Kotlin

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

Groovy

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

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

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

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

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

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

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

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

Обязательно зарегистрируйте тестовое устройство в AdMob.

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

Java

LineMediationAdapter.Companion.setTestMode(true);

Kotlin

LineMediationAdapter.setTestMode(true)

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

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

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

Параметры для сетей

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

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

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

Java

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

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

Kotlin

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

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

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

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

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

Поле Объекты, которые всегда добавляются адаптером рекламной сети LY Ads
Заголовок
Изображение
Body
Значок приложения 1
Призыв к действию
Оценка
Магазин
Цена

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

Коды ошибок

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

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

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

Код ошибки Поместье Причина
1-10 com.five_corp.ad SDK рекламной сети LY Ads вернул ошибку, связанную с SDK. Дополнительную информацию можно найти в документации рекламной сети LY Ads Network.
101 com.google.ads.mediation.line Идентификатор приложения отсутствует или недействителен.
102 com.google.ads.mediation.line Идентификатор рекламного места отсутствует или недействителен.
103 com.google.ads.mediation.line Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому рекламной сетью LY Ads Network.
104 com.google.ads.mediation.line Не удалось загрузить межстраничное объявление или объявление с вознаграждением из-за отсутствия контекста действия.
105 com.google.ads.mediation.line Не удалось показать межстраничное объявление или объявление с вознаграждением из SDK рекламной сети LY Ads.
106 com.google.ads.mediation.line Не удалось загрузить нативное объявление из-за отсутствия объектов.
107 com.google.ads.mediation.line FiveAd SDK вернул нулевой загрузчик объявлений.

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

Следующая версия

  • Адаптер обновлен для использования InitializationCompleteCallback.onInitializationFailed(AdError) API.

Версия 3.2.0.0

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

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

  • Google Mobile Ads SDK версии 25.5.0.
  • Google Mobile Ads Next-Gen SDK версии 1.6.0.
  • FiveAd SDK версии 3.2.0.0.

Версия 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

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

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

  • Google Mobile Ads SDK версии 25.4.0.
  • Google Mobile Ads Next-Gen SDK версии 1.2.1.
  • FiveAd SDK версии 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.
  • 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

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

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

  • 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

  • Подтверждена совместимость с 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

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

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

  • 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.
  • Подтверждена совместимость с FiveAd SDK версии 2.7.20240214.

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

  • 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

  • Подтверждена совместимость с 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.
  • FiveAd SDK версии 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.
  • FiveAd SDK версии 2.6.20230607.