Эта страница переведена с помощью Cloud Translation API.

Интегрируйте рекламную сеть LY Ads с системой медиации.

Выберите платформу: Android

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Требования

Android API уровня 23 или выше

Новейший Google Mobile Ads SDK
Заполните руководство по началу медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе рекламной сети LY.

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

Добавить новое приложение

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

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

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

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

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

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

Создать рекламный блок

На вкладке «Приложение» выберите свое приложение, чтобы просмотреть его подробную информацию. В разделе «Слот» нажмите «Добавить ».

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

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

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

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

Подробности слота

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

Запрос на рассмотрение

Создайте ключ API для создания отчетов.

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

Вкладка «Ключ API для отчетов»

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

Форма для ввода ключа API для создания отчетов

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

Форма для ввода ключа API для создания отчетов

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

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

Для внедрения файла app-ads.txt в рекламную сеть LY см. раздел «О файле app-ads.txt» .

Шаг 2: Настройте параметры рекламной сети LY в пользовательском интерфейсе AdMob.

Настройте параметры медиации для вашего рекламного блока.

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

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

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

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте рекламную сеть LY в качестве источника рекламы.

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите рекламную сеть LY Ads Network .

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

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

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

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

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

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

Примечание : Оптимизация источника рекламы занимает несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети медиации. В это время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную установить значение eCPM для сети. Как только eCPM будет рассчитан, источник рекламы автоматически начнет обновлять значение eCPM от вашего имени.

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

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

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

Котлин

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

Классный

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

Ручная интеграция

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

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

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

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

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

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

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

Java

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

Котлин

LineMediationAdapter.setTestMode(true)LineMediationSnippets.kt

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

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

Дополнительные шаги

Параметры, специфичные для сети

Адаптер рекламной сети LY поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса 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

Котлин

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

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

Использование нативной рекламы

Отображение рекламы

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

Поле	Ресурсы всегда включены адаптером рекламной сети LY.
Заголовок
Изображение
Тело
значок приложения	¹
Призыв к действию
Звездный рейтинг
Магазин
Цена

^1. Для нативной рекламы SDK LY Ads Network не предоставляет значок приложения. Вместо этого адаптер 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 вернул ошибку, специфичную для 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 Network не смог показать промежуточную или платную рекламу.
106	com.google.ads.mediation.line	Не удалось загрузить нативную рекламу из-за отсутствия необходимых ресурсов.

Список изменений адаптера LINE для медиации на Android

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

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