В этом руководстве показано, как использовать 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. Настройте спрос на майо в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства поАндроид .
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. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.
Издатели, использующие Google Mobile Ads SDK версии 7.26.0 или выше, при отправке запросов будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отmaio, включите тестирование одного источника объявлений в Инспекторе объявлений с помощью maio (Waterfall) источник(и) рекламы.
,Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.
Издатели, использующие Google Mobile Ads SDK версии 7.26.0 или выше, при отправке запросов будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных в качестве тестовых устройств .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отmaio, включите тестирование одного источника объявлений в Инспекторе объявлений с помощью maio (Waterfall) источник(и) рекламы.
,Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager.
Издатели, использующие 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.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.