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

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

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

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из рекламной сети LY Ads Network с помощью медиации , включая каскадную интеграцию. В нем рассматривается, как добавить 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» , чтобы настроить этот слот для обычных торгов. После заполнения формы нажмите «Создать» .

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

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

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

After you create your first slot, click Review on your app's detail page to get approval from LY Ads Network. This may take some time. Contact your LY Ads Network representative if you have any questions.

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

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

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

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

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

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

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

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

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

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

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

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

Войдите в свой аккаунт в Ad Manager .

Добавить рекламную сеть LY в раздел «Компании»

Торги

Этот шаг не требуется для интеграции с системами торгов.

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

Включить безопасный обмен сигналами

Торги

Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи Ad Exchange , просмотрите и включите параметр «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите рекламную сеть LY Ads Network и включите опцию «Включить интеграцию с приложением» .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка ставок в рекламной сети LY Ads

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

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

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

Нажмите «Готово» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка сопоставления рекламных блоков

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Выберите компанию для рекламной сети LY Ads Network.

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Создать новое сопоставление рекламных блоков» .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и ваше мобильное приложение . Затем введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе.

Наконец, нажмите «Сохранить» .

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» . Выберите свой склад и приложение .

Прокрутите страницу вниз и нажмите «Добавить партнера по медиации» .

Выберите компанию, которую вы создали для рекламной сети LY Ads Network в предыдущем разделе. В качестве типа интеграции выберите «Посредничество Mobile SDK» , в качестве платформы — «Android» , а в качестве статуса — «Активный» .

Enter the Application ID and Slot ID obtained in the previous section, and the Default CPM value. Click Save .

Шаг 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: Протестируйте свою реализацию.

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

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

Адаптер 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 .

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

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

The LY Ads Network adapter supports an additional request parameter which can be passed to the adapter using the LineExtras class. This class constructor includes the following parameters:

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.