This guide shows you how to use Google Mobile Ads Unity Plugin to load and display ads from maio using mediation , covering waterfall integrations. It covers how to add maio to an ad unit's mediation configuration, and how to integrate the maio SDK and adapter into a Unity app.
The dashboard interface for maio uses Japanese text for its labels, buttons, and descriptions, and the screenshots in this guide have not been translated. However, in descriptions and instructions here, labels and buttons are referred to by their English language equivalents. "URL スキーム," for example, is "URL Scheme,".
Поддерживаемые интеграции и форматы рекламы
Адаптер для посредничества на платформе Maio обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальные | |
| Награжден | |
Предварительные требования
Прежде чем продолжить, проверьте следующее:
- Последняя версия Google Mobile Ads Unity Plugin .
- Версия редактора Unity — 4 или более поздняя.
- Для развертывания на Android
- Android API уровня 23 или более поздней версии.
- Для развертывания на iOS
- Целевая версия iOS — 15.0 или более поздняя.
- Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Unity Plugin .
- Организуйте посредничество .
Шаг 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.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads maio Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога проекта:
openupm add com.google.ads.mobile.mediation.maioOpenUPM
В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .
На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM в качестве реестра с ограниченной областью действия, указав следующие данные:
- Имя:
OpenUPM - URL:
https://package.openupm.com - Область применения:
com.google

Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.

Выберите пакет Google Mobile Ads Maio Mediation и нажмите «Установить» .

Пакет Unity
Загрузите последнюю версию плагина Google Mobile Ads Mediation для Maio по ссылке для скачивания в Changelog и извлеките файл GoogleMobileAdsMaioMediation.unitypackage из zip-архива.
In your Unity project editor, select Assets > Import Package > Custom Package and find the GoogleMobileAdsMaioMediation.unitypackage file you downloaded. Make sure that all the files are selected and click Import .

Then, select Assets > External Dependency Manager > Android Resolver > Force Resolve . The External Dependency Manager library will perform dependency resolution from scratch and copy the declared dependencies into the Assets/Plugins/Android directory of your Unity app.

Шаг 4: Добавьте необходимый код
Android
Для интеграции с Maio дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Пользователи Google Mobile Ads Unity Plugin версии 7.26.0 и выше будут автоматически получать тестовые объявления от 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 | Для данной конфигурации сети уже загружена реклама. |
Список изменений плагина Maio Unity Mediation
Версия 3.1.10
- Поддерживает адаптер Maio Android версии 2.0.9.0 .
- Поддерживает адаптер maio для iOS версии 2.2.2.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.4.0.
Версия 3.1.9
- Поддерживает адаптер Maio Android версии 2.0.9.0 .
- Поддерживает адаптер maio для iOS версии 2.2.1.2.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.3.0.
Версия 3.1.8
- Поддерживает адаптер Maio Android версии 2.0.8.2 .
- Поддерживает адаптер maio для iOS версии 2.2.1.2 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.1.0.
Версия 3.1.7
- Поддерживает адаптер Maio Android версии 2.0.8.2 .
- Поддерживает адаптер maio для iOS версии 2.2.1.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 3.1.6
- Поддерживает адаптер Maio Android версии 2.0.8.1 .
- Поддерживает адаптер maio для iOS версии 2.2.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 3.1.5
- Поддерживает адаптер Maio Android версии 2.0.8.0 .
- Поддерживает адаптер maio для iOS версии 2.2.0.3 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 11.0.0.
Версия 3.1.4
- Поддерживает адаптер Maio Android версии 2.0.8.0 .
- Поддерживает адаптер maio для iOS версии 2.2.0.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.6.0.
Версия 3.1.3
- Поддерживает адаптер Maio Android версии 2.0.7.0 .
- Поддерживает адаптер maio для iOS версии 2.2.0.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.6.0.
Версия 3.1.2
- Поддерживает адаптер Maio Android версии 2.0.7.0 .
- Поддерживает адаптер maio для iOS версии 2.2.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.6.0.
Версия 3.1.1
- Поддерживает адаптер Maio Android версии 2.0.6.0 .
- Поддерживает адаптер maio для iOS версии 2.2.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.5.0.
Версия 3.1.0
- Поддерживает адаптер Maio Android версии 2.0.5.0 .
- Поддерживает адаптер maio для iOS версии 2.2.0.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.5.0.
Версия 3.0.2
- Поддерживает адаптер Maio Android версии 2.0.5.0 .
- Поддерживает адаптер maio для iOS версии 2.1.6.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.2.0.
Версия 3.0.1
- Поддерживает адаптер Maio Android версии 2.0.4.0 .
- Поддерживает адаптер maio для iOS версии 2.1.6.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.2.0.
Версия 3.0.0
- Обновлен плагин для включения динамической платформы
MaioSDK-v2для всех целевых платформ iOS. - Поддерживает адаптер Maio Android версии 2.0.3.1 .
- Поддерживает адаптер maio для iOS версии 2.1.6.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 10.0.0.
Версия 2.0.4
- Поддерживает адаптер Maio Android версии 1.1.16.3 .
- Поддерживает адаптер maio для iOS версии 2.1.5.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 9.3.0.
Версия 2.0.3
- Поддерживает адаптер Maio Android версии 1.1.16.3 .
- Поддерживает адаптер maio для iOS версии 2.1.5.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 9.1.0.
Версия 2.0.2
- Поддерживает адаптер Maio Android версии 1.1.16.3 .
- Поддерживает адаптер maio для iOS версии 2.1.4.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.0.1
- Поддерживает адаптер Maio Android версии 1.1.16.2 .
- Поддерживает адаптер maio для iOS версии 2.1.3.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 9.0.0.
Версия 2.0.0
- Поддерживает адаптер Maio Android версии 1.1.16.2 .
- Поддерживает адаптер maio для iOS версии 2.1.1.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 8.6.0.
Версия 1.4.3
- Содержимое адаптера перемещено в
GoogleMobileAds/Mediation/Maio/. - Поддерживает адаптер Maio Android версии 1.1.16.2 .
- Поддерживает адаптер maio для iOS версии 1.6.3.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 8.1.0.
Версия 1.4.2
- Поддерживает адаптер Maio Android версии 1.1.16.1 .
- Поддерживает адаптер maio для iOS версии 1.6.3.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 7.4.0.
Версия 1.4.1
- Поддерживает адаптер Maio Android версии 1.1.16.1 .
- Поддерживает адаптер maio для iOS версии 1.6.2.0 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 7.1.0.
Версия 1.4.0
- Поддерживает адаптер Maio Android версии 1.1.16.0 .
- Поддерживает адаптер maio для iOS версии 1.6.0.1 .
- Разработано и протестировано с использованием плагина Google Mobile Ads Unity версии 7.0.0.
Версия 1.3.6
- Поддерживает адаптер Maio Android версии 1.1.16.0 .
- Поддерживает адаптер maio для iOS версии 1.5.8.0 .
Версия 1.3.5
- Поддерживает адаптер Maio Android версии 1.1.15.0 .
- Поддерживает адаптер maio для iOS версии 1.5.6.1 .
Версия 1.3.4
- Поддерживает адаптер Maio Android версии 1.1.11.1 .
- Поддерживает адаптер maio для iOS версии 1.5.4.0 .
Версия 1.3.3
- Поддерживает адаптер Maio Android версии 1.1.11.1 .
- Поддерживает адаптер maio для iOS версии 1.5.3.1 .
Версия 1.3.2
- Поддерживает адаптер Maio Android версии 1.1.11.0 .
- Поддерживает адаптер maio для iOS версии 1.5.2.1 .
Версия 1.3.1
- Поддерживает адаптер Maio Android версии 1.1.10.0 .
- Поддерживает адаптер maio для iOS версии 1.5.1.0 .
Версия 1.3.0
- Поддерживает адаптер Maio Android версии 1.1.10.0 .
- Поддерживает адаптер maio для iOS версии 1.5.0.0 .
Версия 1.2.3
- Плагин обновлен для поддержки нового API вознаграждений.
- Поддерживает адаптер maio Android версии 1.1.7.0.
- Поддерживает адаптер maio для iOS версии 1.4.6.0.
Версия 1.2.2
- Поддерживает адаптер Maio Android версии 1.1.6.0.
- Поддерживает адаптер maio для iOS версии 1.4.2.0.
Версия 1.2.1
- Поддерживает адаптер Maio Android версии 1.1.6.0.
- Поддерживает адаптер maio для iOS версии 1.4.1.0.
Версия 1.2.0
- Поддерживает адаптер Maio Android версии 1.1.4.1.
- Поддерживает адаптер maio для iOS версии 1.4.0.0.
Версия 1.1.3
- Поддерживает адаптер Maio Android версии 1.1.3.1.
- Поддерживает адаптер maio для iOS версии 1.3.2.0.
Версия 1.1.2
- Поддерживает адаптер Maio Android версии 1.1.3.0.
- Поддерживает адаптер maio для iOS версии 1.3.2.0.
Версия 1.1.1
- Поддерживает адаптер Maio Android версии 1.1.1.0.
- Поддерживает адаптер maio для iOS версии 1.3.1.1.
Версия 1.1.0
- Поддерживает адаптер Maio Android версии 1.1.0.0.
- Поддерживает адаптер maio для iOS версии 1.3.0.0.
Версия 1.0.2
- Поддерживает версию Android SDK maio 1.0.8.
- Поддерживает версию iOS SDK maio 1.2.19.
Версия 1.0.1
- Поддерживает версию Android SDK maio 1.0.7.
- Поддерживает версию iOS SDK maio 1.2.19.
Версия 1.0.0
- Первый релиз!
- Поддерживает версию Android SDK maio 1.0.6.
- Поддерживает версию iOS SDK maio 1.2.18.