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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads SDK for React Native.
  • Фреймворк React Native версии 0.85.0 или более поздней.
  • Развертывание на устройствах Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на iOS:
    • iOS 13.0 или более поздней версии.
  • Работающий проект React Native, настроенный с помощью Google Mobile Ads SDK for React Native. Подробные сведения приведены в статье Как настроить Google Mobile Ads SDK for React Native.
  • Настройте медиацию AdMob.

Шаг 1. Задайте настройки в интерфейсе рекламной сети LY Ads

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

Добавить рекламное место

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

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

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

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

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

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

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

Перейдите на вкладку Управление ключами Reporting 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 Ads Network в интерфейсе AdMob

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

Android

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

iOS

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

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

В корневом каталоге проекта установите адаптер медиации Google Mobile Ads SDK for React Native для рекламной сети LY Ads Network. Выполните следующие действия:

  1. Скопируйте tar-файл адаптера Google Mobile Ads SDK for React Native из каталога gma-sdk-react-native/adapters/line/ в каталог local_packages/ проекта. Если у вас нет папки adapters, ознакомьтесь с разделом Предварительные требования.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/

    Замените EXTRACT_DIR путем к каталогу, в который вы распаковали архив.

  2. Установите пакет адаптера с помощью предпочитаемого менеджера пакетов:

    npm

    npm install ./local_packages/gma-mediation-line-0.1.0.tgz

    пряжа

    yarn add ./local_packages/gma-mediation-line-0.1.0.tgz

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

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

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

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

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

Параметры для сетей

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

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

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

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

Коды ошибок

Если адаптер не получает объявление от рекламной сети 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 Network вернул ошибку, связанную с 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 Отправлено LY Ads Network SDK SDK LY Ads Network вернул ошибку, связанную с 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.

Версия 0.1.0

  • Первый выпуск.