Поделитесь своим мнением о GMA Next-Gen SDK в Discord-канале #gma-next-gen-sdk на сервере сообщества Google Advertising and Measurement.

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

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

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

This guide shows you how to use GMA Next-Gen SDK to load and display ads from LY Ads Network using AdMob Mediation , covering waterfall integrations. It covers how to add LY Ads Network to an ad unit's mediation configuration, and how to integrate the LY Ads Network SDK and adapter into an Android app.

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

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

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

Предварительные требования

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

Android API уровня 24 или более поздней версии.
[Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему торгов, используйте адаптер LY Ads Network версии 2.9.20241129.0 или более поздней ( рекомендуется последняя версия ).

Последняя версия GMA Next-Gen SDK .
Настройте медиацию AdMob .

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

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

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

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

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

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

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

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

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

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

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

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

Fill out the form for details about the slot. For Bidding Type , select Standard to configure this slot for waterfall mediation, or Google SDK Bidding to configure this slot for Bidding. Click Create once the form is filled.

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

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

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

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.

Authorized Sellers for Apps app-ads.txt is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an app-ads.txt file. If you haven't done so already, set up an app-ads.txt file for your app .

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

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

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

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

First, sign in to your AdMob account . Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add LY Ads Network as an ad source .

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

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

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

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

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

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

Торги

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

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

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

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

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

Водопад

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

Select LY Ads Network and enable the Optimize switch. Enter the API Key ID and API Key Secret obtained in the previous section to set up ad source optimization for LY Ads Network. Then enter an eCPM value for LY Ads Network and click Continue .

Note : Ad source optimization takes a few days to gather enough data to accurately calculate eCPM for a mediation network. In the meantime, the ad source optimization status is PENDING , so you must manually set an eCPM value for the network. Once the eCPM can be calculated, the ad source automatically starts updating the eCPM on your behalf.

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

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

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

Котлин

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:line:3.1.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Классный

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1'
    implementation 'com.google.ads.mediation:line:3.1.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

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

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

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

The LY Ads Network adapter contains a helper method to enable test mode for LY Ads Network. You must set this option before you initialize GMA Next-Gen SDK to ensure they get forwarded properly to the 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.getAdSourceResponses() из следующих классов:

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	Не удалось загрузить нативную рекламу из-за отсутствия необходимых ресурсов.