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

В этом руководстве показано, как использовать 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

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

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

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

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

OpenUPM-CLI

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

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

ОпенУПМ

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

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

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

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

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

Реестры Unity

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

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

Пакет Единства

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

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

Импорт из Unity

Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «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

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

  • Обновлен плагин для поддержки нового 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.