В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из maio с помощью медиации , а также рассматривается каскадная интеграция. В нем рассказывается, как добавить maio в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер maio в приложение Unity.
В интерфейсе информационной панели maio для меток, кнопок и описаний используется текст на японском языке, а снимки экрана в этом руководстве не переведены. Однако в приведенных здесь описаниях и инструкциях метки и кнопки обозначаются их английскими эквивалентами. Например, «URL スキーム» — это «Схема URL».
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для maio имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничные объявления | |
Награжден |
Требования
- Юнити 4 или выше
- Последняя версия Google Mobile Ads SDK
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе maio.
Сначала зарегистрируйтесь или войдите в свою учетную запись maio. Нажмите кнопку «Управление приложениями» на левой боковой панели и выберите «Новое приложение» .
Выберите вкладку, соответствующую предпочитаемому типу объявления .
Межстраничный
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . В качестве типа объявления выберите «Межстраничное видео» и нажмите «Обновить» .
Андроид
iOS
Награжден
Введите название вашего приложения, выберите платформу и укажите URL-адрес вашего приложения . Выберите «Видео-награды» в качестве типа объявления и нажмите «Обновить» .
Андроид
iOS
На странице «Управление приложениями » запишите идентификатор носителя . В следующем разделе необходимо настроить рекламный блок AdMob.
Андроид
iOS
На странице «Управление зоной » запишите идентификатор зоны . Это также потребуется для настройки рекламного блока AdMob в следующем разделе.
Андроид
iOS
Шаг 2. Настройте запрос maio в интерфейсе AdMob.
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3. Импортируйте maio SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин посредничества Google Mobile Ads maio для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.maio
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет медиации Google Mobile Ads maio и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию подключаемого модуля медиации Google Mobile Ads для maio по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsMaioMediation.unitypackage
из ZIP-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMaioMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Добавьте необходимый код
Андроид
Для интеграции maio не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob.
Издатели, использующие Google Mobile Ads SDK версии 7.26.0 или выше, при отправке запросов будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от maio, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений maio (Waterfall) .
Коды ошибок
Если адаптеру не удается получить объявление от maio, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
Формат | Имя класса |
---|---|
Межстраничный | jp.maio.sdk.android.mediation.admob.adapter.Межстраничное объявление |
Награжден | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
Формат | Имя класса |
---|---|
Межстраничный | GADMMaioМежстраничный адаптер |
Награжден | GADMMaioRewardedАдаптер |
Вот коды и сопутствующие сообщения, выдаваемые адаптером maio, когда реклама не загружается:
Андроид
Код ошибки | Причина |
---|---|
0-10 | maio вернул ошибку, специфичную для SDK. Дополнительные сведения см. в документации по коду и maio. |
101 | У Майо нет доступного объявления. |
102 | Неверные параметры сервера (например, отсутствует идентификатор места размещения). |
103 | Контекст, используемый для загрузки объявления, не был экземпляром «Активность». |
iOS
Код ошибки | Причина |
---|---|
0-10 | maio вернул ошибку, специфичную для SDK. Более подробную информацию смотрите в коде maio. |
101 | У maio пока нет доступного объявления. |
102 | Неверные параметры сервера (например, отсутствует идентификатор места размещения). |
103 | Адаптер maio не поддерживает запрошенный формат объявления. |
104 | Объявление для этой конфигурации сети уже загружено. |
Журнал изменений плагина maio Unity Mediation
Версия 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
- Обновлен плагин для поддержки нового Rewarded 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
- Поддерживает maio Android SDK версии 1.0.8.
- Поддерживает maio iOS SDK версии 1.2.19.
Версия 1.0.1
- Поддерживает maio Android SDK версии 1.0.7.
- Поддерживает maio iOS SDK версии 1.2.19.
Версия 1.0.0
- Первый выпуск!
- Поддерживает maio Android SDK версии 1.0.6.
- Поддерживает maio iOS SDK версии 1.2.18.