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

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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads Flutter Plugin.
  • Фреймворк Flutter версии 3.7.0 или более поздней.
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая версия iOS – 13.0 или более поздняя.
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads Flutter Plugin. Подробная информация приведена в статье Как настроить Google Mobile Ads Flutter Plugin.
  • Настройте медиацию AdMob.

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Сведения о слоте

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

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

Как создать ключ 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 Ads Network, ознакомьтесь с информацией о файле app-ads.txt.

Шаг 2. Настройте источник спроса LY Ads Network в интерфейсе AdMob

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

Android

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

iOS

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

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

Интеграция через pub.dev

Добавьте в файл pubspec.yaml пакета следующую зависимость с последними версиями LY Ads Network SDK и адаптера:

dependencies:
  gma_mediation_line: ^2.2.1

Интеграция с настройкой вручную

Скачайте последнюю версию плагина медиации Google Mobile Ads для LY Ads Network, извлеките скачанный файл и добавьте извлеченную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

Шаг 4. Добавьте обязательный код

Android

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

iOS

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

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

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

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

Зарегистрируйте тестовое устройство в AdMob.

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

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

Необязательные действия

Параметры, относящиеся к определенной сети

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

  • enableAdSound – определяет состояние звука по умолчанию для баннеров, межстраничных объявлений и объявлений с вознаграждением.

Ниже приведен пример кода, в котором показано, как создать запрос объявления с этими параметрами:

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [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 Не удалось показать межстраничное объявление или объявление с вознаграждением из LY Ads Network SDK.
106 com.google.ads.mediation.line Не удалось загрузить нативное объявление из-за отсутствия объектов.
107 com.google.ads.mediation.line SDK FiveAd вернул пустой загрузчик объявлений.

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 Не удалось инициализировать загрузчик объявлений LINE Ads SDK.

Журнал изменений адаптера медиации Line Flutter

Версия 2.2.1

Версия 2.2.0

Версия 2.1.3

Версия 2.1.2

Версия 2.1.1

Версия 2.1.0

Версия 2.0.0

Версия 1.0.6

Версия 1.0.5

Версия 1.0.4

Версия 1.0.3

Версия 1.0.2

Версия 1.0.1

Версия 1.0.0