Как интегрировать maio с медиацией

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

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

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

Поддерживаемые интеграции и форматы объявлений

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

Интеграция
Ставки
Водопад
Форматы
Открытие приложения
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

  • Последняя версия Google Mobile Ads Unity Plugin.
  • Редактор Unity версии 4 или более поздней.
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая версия iOS – 15.0 или более поздняя.
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads Unity Plugin. Подробнее о том, как настроить Google Mobile Ads Unity Plugin…
  • Настройте медиацию AdMob.

Шаг 1. Настройте конфигурации в интерфейсе maio

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

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

Межстраничное объявление

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

Android

iOS

Бонус предоставлен

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

Android

iOS

На странице Application Management (Управление приложениями) запишите Media ID (Идентификатор медиаконтента). Он понадобится вам, чтобы настроить рекламный блок AdMob в следующем разделе.

Android

iOS

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

Android

iOS

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

Шаг 2. Настройте источник спроса maio в интерфейсе AdMob

Как настроить медиацию для рекламного блока

Android

Инструкции приведены в разделе "Шаг 2" Android.

iOS

Инструкции приведены в разделе "Шаг 2" руководства для iOS.

Шаг 3. Импортируйте SDK и адаптер maio

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI, вы можете добавить в проект плагин медиации Google Mobile Ads для maio, выполнив следующую команду в корневом каталоге проекта:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

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

На вкладке Scoped Registries (Реестры с областью действия) добавьте OpenUPM в качестве реестра с областью действия, указав следующие сведения:

  • Название: OpenUPM
  • URL: https://package.openupm.com
  • Области действия: com.google

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

Затем выберите Window (Окно) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager (Менеджер пакетов Unity), и в раскрывающемся меню выберите My Registries (Мои реестры).

Реестры Unity

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

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

Пакет Unity

Скачайте последнюю версию плагина медиации Google Mobile Ads для maio по ссылке в журнале изменений и извлеките файл GoogleMobileAdsMaioMediation.unitypackage из ZIP-архива.

В редакторе проекта Unity выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Специальный пакет) и найдите скачанный файл GoogleMobileAdsMaioMediation.unitypackage. Убедитесь, что выбраны все файлы, и нажмите Импортировать.

Импорт из Unity

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

Принудительное разрешение

Шаг 4. Добавьте обязательный код

Android

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

iOS

Интеграция с SKAdNetwork

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

Шаг 5. Проверьте реализацию

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

Зарегистрируйте тестовое устройство в AdMob.

Издатели, использующие версию 7.26.0 или более позднюю версию Google Mobile Ads Unity Plugin, будут автоматически получать тестовые объявления от maio на телефонах и планшетах, зарегистрированных как тестовые устройства, при отправке запросов.

Как проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от maio, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источник объявлений maio (каскад).

Коды ошибок

Если адаптер не получает объявление от 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 В Maio нет доступного объявления.
102 Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
103 Контекст, использованный для загрузки объявления, не является экземпляром Activity.

iOS

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

История изменений плагина для медиации maio Unity

Версия 3.1.11

Версия 3.1.10

Версия 3.1.9

Версия 3.1.8

Версия 3.1.7

Версия 3.1.6

Версия 3.1.5

Версия 3.1.4

Версия 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

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