Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как с помощью GMA Next-Gen SDK загружать и показывать объявления из рекламной сети LY Ads Network, используя медиацию AdMob и каскадную интеграцию. В ней рассказывается, как добавить рекламную сеть 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.
Настройте медиацию AdMob.

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

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

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

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

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

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

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

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

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

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

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

Добавить место

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

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

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

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

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

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

Как создать ключ 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 и нажмите Продолжить.

Примечание. Чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов в сети медиации, требуется несколько дней. Пока статус оптимизации источника объявлений – PENDING, вам нужно вручную задать значение эффективной цены за тысячу показов для сети. После этого источник объявлений начнет автоматически обновлять эффективную цену за тысячу показов от вашего имени.

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

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

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

Kotlin

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")
}

Groovy

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'
}

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

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

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

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

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

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

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

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

Java

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

Kotlin

LineMediationAdapter.setTestMode(true)LineMediationSnippets.kt

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

Чтобы убедиться, что вы получаете тестовые объявления из рекламной сети 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();LineMediationSnippets.java

Kotlin

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
Заголовок
Изображение
Body
Значок приложения	¹
Призыв к действию
Оценка
Магазин
Цена

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

Коды ошибок

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

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

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

Код ошибки	Поместье	Причина
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 вернул нулевой загрузчик объявлений.