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

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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

    Android

    iOS

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

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

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

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

    Android

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

    iOS

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

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

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

    (Только для Android.) Добавьте следующие репозитории в файл build.gradle в каталоге android проекта:

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

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

    dependencies:
  gma_mediation_maio: ^1.1.8

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

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

    dependencies:
  gma_mediation_maio:
    path: path/to/local/package

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

    Android

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

    iOS

    Интеграция SKAdNetwork

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

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

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

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

    Издатели, использующие Google Mobile Ads Flutter Plugin версии 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 Для этой конфигурации сети уже загружено объявление.

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

    Версия 1.1.8

    Версия 1.1.7

    Версия 1.1.6

    Версия 1.1.5

    Версия 1.1.4

    Версия 1.1.3

    Версия 1.1.2

    Версия 1.1.1

    Версия 1.1.0

    Версия 1.0.3

    Версия 1.0.2

    Версия 1.0.1

    Версия 1.0.0