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

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

Интерфейс панели управления maio, включая ярлыки, кнопки и описания, представлен на японском языке. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях здесь ярлыки и кнопки упоминаются по их эквивалентам на английском языке. "URL スキーム," for example, is "URL Scheme,".

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

Адаптер медиации для maio обладает следующими возможностями:

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

Требования

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

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

Шаг 1. Задайте настройки в интерфейсе maio

Зарегистрируйтесь или войдите в аккаунт maio. Нажмите кнопку Application management (Управление приложениями) на боковой панели слева и выберите New app (Новое приложение).

Выберите вкладку, соответствующую нужному типу объявления.

Межстраничное объявление

Введите название приложения, выберите платформу и укажите URL приложения. В качестве типа объявления выберите Межстраничное видеообъявление и нажмите Обновить.

Android

iOS

Бонус предоставлен

Введите название приложения, выберите платформу и укажите URL приложения. В качестве типа объявления выберите Видеореклама с вознаграждением и нажмите Обновить.

Android

iOS

На странице Application Management (Управление приложениями) запишите Media ID (Идентификатор мультимедийного объекта). Он понадобится вам для настройки рекламного блока AdMob в следующем разделе.

Android

iOS

На странице Zone Management (Управление зонами) запишите Zone ID (Идентификатор зоны). Он также понадобится для настройки рекламного блока AdMob в следующем разделе.

Android

iOS

(Только для каскада.) Помимо идентификатора мультимедийного объекта и идентификатора зоны, вам понадобятся идентификатор API и ключ API, чтобы настроить идентификатор рекламного блока для медиации. На странице Reporting API запишите идентификатор API и ключ API.

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

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

Android

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

iOS

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

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

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

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

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

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

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

    npm

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

    пряжа

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

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

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

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

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

Издатели, использующие Google Mobile Ads SDK for React Native версии 7.26.0 или более поздней, будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных как тестовые устройства, при отправке запросов.

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

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

Коды ошибок

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

Android

Формат Название класса
Межстраничное объявление jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Бонус предоставлен jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Формат Название класса
Межстраничное объявление GADMMaioInterstitialAdapter
Бонус предоставлен GADMMaioRewardedAdapter

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

Android

Код ошибки Причина
0-10 maio возвращает ошибку, связанную с SDK. Дополнительную информацию можно найти в коде и документации maio.
101 В Maio нет доступных объявлений.
102 Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
103 Контекст, использованный для загрузки объявления, не был экземпляром `Activity`.

iOS

Код ошибки Причина
0-10 maio возвращает ошибку, связанную с SDK. Дополнительную информацию можно найти в коде maio.
101 В maio пока нет доступных объявлений.
102 Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
103 Адаптер maio не поддерживает запрашиваемый формат объявления.
104 Для этой конфигурации сети уже загружено объявление.

Версия 0.1.0

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