Интегрируйте maio с медиацией

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

Интерфейс панели управления Maio использует японский текст для надписей, кнопок и описаний, и скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях для надписей и кнопок используются их английские эквиваленты. Например, «URL スキーム» — это «URL Scheme».

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициалы
Награжден

Требования

  • Последняя версия Google Mobile Ads SDK
  • Unity 4 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Завершить посредничество . Руководство по началу работы.

Шаг 1: Настройка конфигураций в пользовательском интерфейсе Maio

Сначала зарегистрируйтесь или войдите в свою учётную запись Maio. Нажмите кнопку «Управление приложениями» на левой боковой панели и выберите «Новое приложение» .

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

Интерстициальный

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

Андроид

iOS

Награжден

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

Андроид

iOS

На странице управления приложениями запишите идентификатор медиа . Он понадобится для настройки рекламного блока AdMob в следующем разделе.

Андроид

iOS

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

Андроид

iOS

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

Шаг 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

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

Подробности OpenUPM

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

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

Установить из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина медиации Google Mobile Ads для Maio по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsMaioMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMaioMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог 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.Interstitial
Награжден jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

Формат Имя класса
Интерстициальный GADMMaioInterstitialAdapter
Награжден GADMMaioRewardedAdapter

Вот коды и сопроводительные сообщения, выдаваемые адаптером Maio, когда реклама не загружается:

Андроид

Код ошибки Причина
0-10 maio вернул ошибку, специфичную для SDK. Подробнее см. код и документацию maio.
101 У Maio нет доступной рекламы.
102 Неверные параметры сервера (например, отсутствует идентификатор размещения).
103 Контекст, использованный для загрузки рекламы, не является экземпляром `Activity`.

iOS

Код ошибки Причина
0-10 maio вернул ошибку, специфичную для SDK. Подробнее см. в коде maio.
101 У maio пока нет доступной рекламы.
102 Неверные параметры сервера (например, отсутствует идентификатор размещения).
103 Адаптер maio не поддерживает запрошенный формат рекламы.
104 Для этой конфигурации сети уже загружено объявление.

Журнал изменений плагина-медиатора Unity maio

Версия 3.0.2

Версия 3.0.1

Версия 3.0.0

  • Обновлен плагин для включения динамической платформы MaioSDK-v2 для всех целевых устройств iOS.
  • Поддерживает адаптер Android версии 2.0.3.1 .
  • Поддерживает адаптер iOS версии 2.1.6.1 .
  • Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.0.0.

Версия 2.0.4

Версия 2.0.3

Версия 2.0.2

Версия 2.0.1

Версия 2.0.0

Версия 1.4.3

Версия 1.4.2

Версия 1.4.1

Версия 1.4.0

Версия 1.3.6

Версия 1.3.5

Версия 1.3.4

Версия 1.3.3

Версия 1.3.2

Версия 1.3.1

Версия 1.3.0

Версия 1.2.3

  • Обновлен плагин для поддержки нового API Rewarded.
  • Поддерживает Android-адаптер версии 1.1.7.0.
  • Поддерживает адаптер iOS версии 1.4.6.0.

Версия 1.2.2

  • Поддерживает адаптер Android версии 1.1.6.0.
  • Поддерживает адаптер iOS версии 1.4.2.0.

Версия 1.2.1

  • Поддерживает адаптер Android версии 1.1.6.0.
  • Поддерживает адаптер iOS версии 1.4.1.0.

Версия 1.2.0

  • Поддерживает Android-адаптер версии 1.1.4.1.
  • Поддерживает адаптер iOS версии 1.4.0.0.

Версия 1.1.3

  • Поддерживает Android-адаптер версии 1.1.3.1.
  • Поддерживает адаптер iOS версии 1.3.2.0.

Версия 1.1.2

  • Поддерживает адаптер Android версии 1.1.3.0.
  • Поддерживает адаптер iOS версии 1.3.2.0.

Версия 1.1.1

  • Поддерживает адаптер Android версии 1.1.1.0.
  • Поддерживает адаптер iOS версии 1.3.1.1.

Версия 1.1.0

  • Поддерживает адаптер Android версии 1.1.0.0.
  • Поддерживает адаптер 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.