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

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

This guide shows you how to use Google Mobile Ads Unity Plugin to load and display ads from LY Ads Network using 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 a Unity app.

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

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

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

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

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

  • Последняя версия Google Mobile Ads Unity Plugin .
  • Версия редактора Unity — 4 или более поздняя.
  • [Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему торгов, используйте плагин медиации Google Mobile Ads для рекламной сети LY Ads Network версии 1.5.0 или более поздней ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или более поздней версии.
  • Для развертывания на iOS
    • Целевая версия iOS — 13.0 или более поздняя.
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Unity Plugin .
  • Организуйте посредничество .

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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.

Файл 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.

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

Android

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

OpenUPM-CLI

If you have OpenUPM-CLI installed, you can install the Google Mobile Ads LY Ads Network Mediation Plugin for Unity to your project by running the following command from your project's root directory:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .

На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM в качестве реестра с ограниченной областью действия, указав следующие данные:

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Область применения: com.google

Подробности об OpenUPM

Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.

Реестры единства

Выберите пакет Google Mobile Ads Line Mediation и нажмите «Установить» .

Установка из OpenUPM

Пакет Unity

Download the latest version of Google Mobile Ads mediation plugin for LY Ads Network from the download link in the Changelog and extract the GoogleMobileAdsLineMediation.unitypackage from the zip file.

In your Unity project editor, select Assets > Import Package > Custom Package and find the GoogleMobileAdsLineMediation.unitypackage file you downloaded. Make sure that all the files are selected and click Import .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Силовое разрешение

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

Android

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

iOS

Интеграция SKAdNetwork

Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации LY Ads Network .

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

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

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

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

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

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

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

Плагин медиации LY Ads Network Unity поддерживает следующий дополнительный параметр запроса, который можно передать адаптеру через класс LineMediationExtras :

  • SetEnableAdSound(boolean) : Задает состояние начала воспроизведения звука по умолчанию для баннерной, межстраничной и рекламной рекламы с вознаграждением.

Вот пример кода, демонстрирующий, как создать запрос на показ рекламы, который устанавливает эти параметры:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

коды ошибок

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

Android 

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

iOS 

GADMediationAdapterLine

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

Android

Код ошибки Домен Причина
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 Не удалось загрузить нативную рекламу из-за отсутствия необходимых ресурсов.
107 com.google.ads.mediation.line FiveAd SDK вернул нулевой рекламный блокировщик.

iOS

Код ошибки Домен Причина
1-10 Отправлено с помощью SDK рекламной сети LY SDK рекламной сети LY вернул ошибку, специфичную для SDK. Для получения более подробной информации см. документацию LY Ads Network.
101 com.google.ads.mediation.line Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор слота).
102 com.google.ads.mediation.line Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому рекламной сетью LY Ads Network.
103 com.google.ads.mediation.line Не удалось загрузить изображение информационного значка в нативной рекламе.
104 com.google.ads.mediation.line Не удалось собрать сигналы для участия в торгах.
105 com.google.ads.mediation.line Не удалось инициализировать загрузчик рекламы LINE Ads SDK.

Список изменений плагина Line Unity Mediation

Версия 2.2.0

Версия 2.1.1

Версия 2.1.0

Версия 2.0.2

Версия 2.0.1

Версия 2.0.0

Версия 1.5.10

Версия 1.5.9

Версия 1.5.8

Версия 1.5.7

Версия 1.5.6

Версия 1.5.5

  • Исправлена ​​ошибка, из-за которой установка через OpenUPM приводила к некорректному импорту пакетов плагином.

Версия 1.5.4

Версия 1.5.3

Версия 1.5.2

Версия 1.5.1

Версия 1.5.0

Версия 1.4.0

Версия 1.3.1

Версия 1.3.0

Версия 1.2.0

Версия 1.1.2

Версия 1.1.1

Версия 1.1.0

Версия 1.0.0