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

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

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

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

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

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

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

Требования

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

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

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

    Зарегистрируйтесь или войдите в аккаунт maio. Нажмите кнопку Application management (Управление приложениями) на боковой панели слева и выберите New app (Новое приложение).

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

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

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

    Android

    iOS

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

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

    Android

    iOS

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

    Android

    iOS

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

    Android

    iOS

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

    Шаг 2. Настройте спрос maio в интерфейсе Менеджера рекламы

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

    Android

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

    iOS

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

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

    OpenUPM-CLI

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

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

    OpenUPM

    В редакторе проекта Unity выберите Edit (Изменить) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager Settings (Настройки менеджера пакетов 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

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

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

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

    Зарегистрируйте тестовое устройство в Менеджере рекламы.

    Издатели, использующие Google Mobile Ads Unity Plugin версии 7.26.0 или более поздней, будут автоматически получать тестовые объявления от 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.