Как интегрировать LY Ads Network с медиацией

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

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

Поддерживаемые интеграции и форматы объявлений

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен

Требования

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

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

    • Шаг 1. Настройте конфигурации в интерфейсе LY Ads Network

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

    Как добавить новое приложение

    Перейдите на вкладку App (Приложение) и нажмите кнопку New registration (Новая регистрация).

    Регистрация нового участника

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

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

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

    Android

    Сведения о регистрации

    iOS

    Сведения о регистрации

    Как создать рекламное место

    На вкладке Приложение выберите приложение, чтобы посмотреть подробные сведения о нем. В разделе Слот нажмите Добавить.

    Добавить место

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

    Добавление формы для места размещения

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

    Сведения о рекламном месте

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

    Запросить проверку

    Как создать ключ Reporting API

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

    Вкладка "Ключ Reporting API"

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

    Форма для получения ключа Reporting API

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

    Форма для получения ключа Reporting API

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

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

    Чтобы реализовать app-ads.txt для рекламной сети LY, ознакомьтесь с информацией о файле app-ads.txt.

    Шаг 2. Настройте спрос от рекламной сети LY в интерфейсе Менеджера рекламы

    Как настроить медиацию для рекламного блока

    Android

    Инструкции приведены в разделе "Шаг 2" Android.

    iOS

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

    Шаг 3. Импортируйте SDK и адаптер LY Ads Network

    OpenUPM-CLI

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

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

    OpenUPM

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

    На вкладке Scoped Registries (Реестры с областью действия) добавьте OpenUPM в качестве реестра с областью действия, указав следующие сведения:

    • Название: OpenUPM
    • URL: https://package.openupm.com
    • Области действия: com.google

    Сведения об OpenUPM

    Затем выберите Window (Окно) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager (Менеджер пакетов Unity), и в раскрывающемся меню выберите My Registries (Мои реестры).

    Реестры Unity

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

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

    Пакет Unity

    Скачайте последнюю версию плагина медиации Google Mobile Ads для рекламной сети LY Ads Network по ссылке для скачивания в списке изменений и извлеките файл GoogleMobileAdsLineMediation.unitypackage из ZIP-архива.

    В редакторе проекта Unity выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Специальный пакет) и найдите скачанный файл GoogleMobileAdsLineMediation.unitypackage. Убедитесь, что выбраны все файлы, и нажмите Импортировать.

    Импорт из Unity

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

    Принудительное решение

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

    Android

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

    iOS

    Интеграция с SKAdNetwork

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

    Шаг 5. Проверьте реализацию

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

    Убедитесь, что вы зарегистрировали тестовое устройство в Менеджере рекламы.

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

    Чтобы убедиться, что вы получаете тестовые объявления из рекламной сети 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 Ads вернул ошибку, связанную с 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 не удалось показать межстраничное объявление или объявление с вознаграждением.
    106 com.google.ads.mediation.line Не удалось загрузить нативное объявление из-за отсутствия объектов.
    107 com.google.ads.mediation.line FiveAd SDK вернул нулевой загрузчик объявлений.

    iOS

    Код ошибки Поместье Причина
    1-10 Отправлено LY Ads Network SDK SDK рекламной сети LY Ads вернул ошибку, характерную для этого 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 Не удалось инициализировать загрузчик объявлений рекламного SDK LINE Ads.

    Журнал изменений плагина медиации Unity

    Версия 2.2.1

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