Интегрируйте 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 вашего приложения . Выберите Video Rewards в качестве Типа рекламы , а затем нажмите Обновить .

андроид

iOS

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

андроид

iOS

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

андроид

iOS

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

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

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

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

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

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

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

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

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

Пакет «Единство»

Загрузите последнюю версию плагина-медиатора Google Mobile Ads для maio по ссылке в журнале изменений и извлеките пакет 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: Добавьте требуемый код

андроид

Для интеграции 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.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.
,

В этом руководстве показано, как использовать 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 вашего приложения . Выберите Video Rewards в качестве Типа рекламы , а затем нажмите Обновить .

андроид

iOS

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

андроид

iOS

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

андроид

iOS

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

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

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

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

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

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

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

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

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

Пакет «Единство»

Загрузите последнюю версию плагина-медиатора Google Mobile Ads для maio по ссылке в журнале изменений и извлеките пакет 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: Добавьте требуемый код

андроид

Для интеграции 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.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.