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

Выберите платформу: Android (бета-версия)Новый Android iOS Unity Flutter

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

В интерфейсе панели управления maio для надписей, кнопок и описаний используется японский текст, а скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях здесь надписи и кнопки обозначаются их английскими эквивалентами. Например, "URL スキーム" заменяется на "URL Scheme".

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

Адаптер для посредничества на платформе Maio обладает следующими возможностями:

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

Требования

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

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

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

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

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

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

Android

iOS

Награжден

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

Шаг 2: Настройка спроса maio в пользовательском интерфейсе AdMob.

Настройте параметры медиации для вашего рекламного блока.

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.maio

OpenUPM

В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .

На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM в качестве реестра с ограниченной областью действия, указав следующие данные:

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Область применения: com.google

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

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

Реестры единства

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

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

Пакет Unity

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

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsMaioMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите Import .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Силовое разрешение

Шаг 4: Добавьте необходимый код

Android

Для интеграции с Maio дополнительный код не требуется.

iOS

Интеграция SKAdNetwork

Следуйте документации maio , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

Шаг 5: Протестируйте свою реализацию.

Включить тестовые объявления

Обязательно зарегистрируйте свое тестовое устройство в AdMob.

Пользователи плагина Google Mobile Ads Unity версии 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.3

Версия 3.1.2

Версия 3.1.1

Версия 3.1.0

Версия 3.0.2

Версия 3.0.1

Версия 3.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 вознаграждений.
  • Поддерживает адаптер 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.