Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

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

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

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

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

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

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

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

Требования

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

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

Последняя версия Google Mobile Ads SDK (Legacy).
Настройте медиацию AdMob.

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавление формы для места размещения

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

Сведения о слоте

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

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

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

Перейдите на вкладку Управление ключами 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 Ads Network, ознакомьтесь с информацией о файле app-ads.txt.

Шаг 2. Настройте источник спроса LY Ads Network в интерфейсе AdMob

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

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

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

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

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

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

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

Ставки

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

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

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

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

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

Водопад

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

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

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

Шаг 3. Импортируйте SDK и адаптер LY Ads Network

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

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

Kotlin

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

Groovy

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

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

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

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

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

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

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

Зарегистрируйте тестовое устройство в AdMob.

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

Java

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

Kotlin

LineMediationAdapter.setTestMode(true)LineMediationSnippets.kt

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

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

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

Параметры, относящиеся к определенной сети

Адаптер LY Ads Network поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса 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 Ads Network
Заголовок
Изображение
Body
Значок приложения	¹
Призыв к действию
Star rating
Магазин
Цена

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

Коды ошибок

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

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	Не удалось показать межстраничное объявление или объявление с вознаграждением из LY Ads Network SDK.
106	com.google.ads.mediation.line	Не удалось загрузить нативное объявление из-за отсутствия объектов.
107	com.google.ads.mediation.line	SDK FiveAd вернул пустой загрузчик объявлений.