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

Выберите платформу: AndroidНовый Android iOS Unity Flutter

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

Заполните форму, чтобы получить подробную информацию о слоте. В поле «Тип торгов» выберите «Стандартный» , чтобы настроить этот слот для каскадной медиации, или «Торги через 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 для 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

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads LY Ads Network Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога проекта:

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

Загрузите последнюю версию плагина Google Mobile Ads Mediation для рекламной сети LY Ads по ссылке для скачивания в разделе Changelog и извлеките файл GoogleMobileAdsLineMediation.unitypackage из архива.

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsLineMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите 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 Не удалось загрузить нативную рекламу из-за отсутствия необходимых ресурсов.

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 Не удалось загрузить изображение информационного значка в нативной рекламе.

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

Версия 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