Как интегрировать i-mobile с медиацией AdMob

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

Интерфейс панели управления i-mobile, включая ярлыки, кнопки и описания, представлен на японском языке. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства ярлыки и кнопки переведены, а их английские эквиваленты указаны в скобках.

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

Адаптер медиации AdMob для i-mobile поддерживает следующие возможности:

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

Требования

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

  • Последняя версия 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. Задайте настройки в интерфейсе i-mobile

Зарегистрируйтесь или войдите в аккаунт i-mobile.

Добавьте приложение на панель управления i-mobile, нажав на вкладку サイト／アプリ管理 (Управление сайтами и приложениями) и кнопку платформы приложения.

Android

iOS

Заполните форму и нажмите кнопку 新規登録 (Зарегистрироваться).

Android

iOS

Чтобы создать рекламное место, выберите приложение на вкладке サイト／アプリ管理 (Управление сайтами и приложениями).

Android

iOS

Перейдите на вкладку 広告スポット管理 (Управление рекламными вставками) и нажмите кнопку 新規広告スポット (Новая рекламная вставка).

create_ad_spot

Заполните форму, указав 広告スポット名 (название рекламной вставки), 広告スポットサイズ (размер рекламной вставки) и другие сведения. Затем нажмите кнопку 新規登録 (Зарегистрироваться).

new_ad_spot_form

Новая рекламная вставка готова. Чтобы посмотреть сведения об интеграции, нажмите кнопку アプリ設定取得 (Получить настройки приложения).

ad_spot_list

Запишите パブリッシャーID (идентификатор издателя), メディアID (идентификатор мультимедийного объекта) и スポットID (идентификатор места). Эти параметры понадобятся вам позже, когда вы будете настраивать медиацию для i-mobile в интерфейсе AdMob.

Android

iOS

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

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

Чтобы реализовать app-ads.txt для i-mobile, ознакомьтесь с часто задаваемыми вопросами.

Шаг 2. Настройте спрос i-mobile в интерфейсе AdMob

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

Android

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

iOS

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

Шаг 3. Импортируйте SDK и адаптер i-mobile

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

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

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

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

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

    npm

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

    пряжа

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

  3. Если вы разрабатываете приложение для Android, добавьте следующий репозиторий в файл build.gradle в каталоге android проекта:

    repositories {
    google()
    mavenCentral()
    maven {
        url = uri("https://imobile.github.io/adnw-sdk-android")
    }
}

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

Android

Для интеграции с i-mobile не требуется дополнительный код.

iOS

Интеграция SKAdNetwork

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

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

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

Обязательно зарегистрируйте тестовое устройство в AdMob. i-mobile предоставляет тестовые идентификаторы Spot ID, Media ID и Publisher ID. Их можно найти здесь.

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

Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений i-mobile (каскад).

Коды ошибок

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

Android

Формат Название класса
Баннер com.google.ads.mediation.imobile.IMobileAdapter
Межстраничное объявление com.google.ads.mediation.imobile.IMobileAdapter
Стандартное com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Формат Название класса
Баннер IMobileAdapter
Межстраничное объявление IMobileAdapter
Стандартное GADMediationAdapterIMobile

Ниже приведены коды и сообщения, которые адаптер i-mobile выдает, когда не удается загрузить объявление.

Android

Код ошибки Причина
0-99 i-mobile SDK вернул ошибку. Подробнее о коде…
101 Для загрузки объявлений i-mobile требуется контекст Activity.
102 Параметры сервера i-mobile, заданные в интерфейсе AdMob, отсутствуют или недействительны.
103 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile.
104 Обратный вызов успешной загрузки объявлений нативного формата i-mobile вернул пустой список нативных объявлений.

iOS

Код ошибки Причина
0-10 i-mobile SDK вернул ошибку. Подробную информацию можно найти в коде.
101 Параметры сервера i-mobile, заданные в интерфейсе AdMob, отсутствуют или недействительны.
102 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile.
103 Сети i-mobile не удалось показать объявление.
104 i-mobile возвращает пустой массив нативных объявлений.
105 Сети i-mobile не удалось скачать объекты нативного объявления.
106 i-mobile не поддерживает запросы нескольких межстраничных объявлений с одним и тем же идентификатором места.

Версия 0.1.0

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