В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из maio с помощью медиации , включая интеграцию по принципу водопада. В нем рассматривается, как добавить maio в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер maio в приложение Flutter.
В интерфейсе панели управления maio для надписей, кнопок и описаний используется японский текст, а скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях здесь надписи и кнопки обозначаются их английскими эквивалентами. Например, "URL スキーム" заменяется на "URL Scheme".
Поддерживаемые интеграции и форматы рекламы
Адаптер для посредничества на платформе Maio обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальные | |
| Награжден | |
| Родной | |
Требования
- Новейший SDK для мобильной рекламы Google
- Flutter 3.7.0 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Целевая версия iOS для развертывания — 12.0 или выше.
- Рабочий проект Flutter, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Заполните руководство по началу медиации.
Шаг 1: Настройка параметров в пользовательском интерфейсе Maio.
Сначала зарегистрируйтесь или войдите в свою учетную запись maio. Нажмите кнопку « Управление приложениями» на левой боковой панели и выберите «Новое приложение» .

Выберите вкладку, соответствующую предпочитаемому вами типу объявления .
Интерстициальный
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите тип рекламы «Видеоинтерстициальная реклама », а затем нажмите «Обновить» .
Android

iOS

Награжден
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите тип рекламы «Видео-награды» , а затем нажмите «Обновить» .
Android

iOS

На странице «Управление приложениями» запишите идентификатор медиафайла (Media ID ). Он понадобится для настройки рекламного блока в Ad Manager в следующем разделе.
Android

iOS

На странице «Управление зонами» запишите идентификатор зоны . Он также понадобится для настройки рекламного блока в Ad Manager в следующем разделе.
Android

iOS


Шаг 2: Настройте запрос maio в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3: Импортируйте SDK и адаптер Maio.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями SDK и адаптера maio в файл pubspec.yaml вашего пакета:
dependencies:
gma_mediation_maio: ^1.1.1
Ручная интеграция
Загрузите последнюю версию плагина Google Mobile Ads Mediation для Maio , распакуйте загруженный файл и добавьте распакованную папку плагина (и её содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_maio:
path: path/to/local/package
Шаг 4: Добавьте необходимый код
Android
Для интеграции с Maio дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Издатели, использующие версию 7.26.0 или выше Google Mobile Ads SDK, будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств, при отправке запросов.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от maio, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и ) объявлений maio (Waterfall ).
коды ошибок
Если адаптер не получает объявление от 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 | У Майо нет доступной рекламы. |
| 102 | Неверные параметры сервера (например, отсутствует идентификатор размещения). |
| 103 | Контекст, использованный для загрузки рекламы, не являлся экземпляром `Activity`. |
iOS
| Код ошибки | Причина |
|---|---|
| 0-10 | Функция maio вернула ошибку, специфичную для SDK. Подробнее см. в коде maio. |
| 101 | На сайте maio пока нет рекламы. |
| 102 | Неверные параметры сервера (например, отсутствует идентификатор размещения). |
| 103 | Адаптер Maio не поддерживает запрашиваемый формат рекламы. |
| 104 | Для данной конфигурации сети уже загружена реклама. |
Список изменений адаптера Flutter Mediation Adapter maio
Версия 1.1.0 (в разработке)
Версия 1.0.3
- Поддерживает адаптер Maio Android версии 2.0.5.0 .
- Поддерживает адаптер maio для iOS версии 2.1.6.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.2
- Поддерживает адаптер Maio Android версии 2.0.4.0 .
- Поддерживает адаптер maio для iOS версии 2.1.6.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.1
- Поддерживает адаптер Maio Android версии 2.0.3.1 .
- Поддерживает адаптер maio для iOS версии 2.1.6.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 6.0.0.
Версия 1.0.0
- Первый релиз.
- Поддерживает адаптер Maio Android версии 2.0.3.0 .
- Поддерживает адаптер maio для iOS версии 2.1.6.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.3.1.