Интегрируйте i-mobile с медиацией

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

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

В интерфейсе панели управления i-mobile для надписей, кнопок и описаний используется японский текст. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства надписи и кнопки переведены, а их английские эквиваленты указаны в скобках.

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

Адаптер AdMob для i-mobile обладает следующими возможностями:

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

Требования

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

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

Зарегистрируйтесь или войдите в свою учетную запись i-mobile.

Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.

Android

iOS

Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .

Android

iOS

Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .

Android

iOS

Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .

create_ad_spot

Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .

новая_рекламная_форма

Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .

список рекламных мест

Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.

Android

iOS

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов рекламы в приложениях , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для своего приложения .

Чтобы внедрить app-ads.txt в i-mobile, ознакомьтесь с разделом часто задаваемых вопросов .

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

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

Android

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

iOS

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

Шаг 3: Импортируйте SDK и адаптер i-mobile.

OpenUPM-CLI

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

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

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 IMobile Mediation и нажмите « Установить» .

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

Пакет Unity

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

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

Импорт из Unity

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

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

Шаг 4: Требуется дополнительный код

Android

Интеграция с iMobile не требует дополнительного кода.

iOS

Интеграция SKAdNetwork

Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации i-mobile .

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob. i-mobile предоставляет тестовые идентификаторы Spot ID , Media ID и Publisher ID для тестирования, вы можете найти их здесь .

Проверить тестовые объявления

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

коды ошибок

Если адаптер не получает рекламу от i-mobile, издатели могут проверить основную причину ошибки в ответе на рекламу, используя класс ResponseInfo из следующих разделов:

Android

Формат Название класса
Баннер com.google.ads.mediation.imobile.IMobileAdapter
Интерстициальный com.google.ads.mediation.imobile.IMobileAdapter
Родной com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Формат Название класса
Баннер IMobileAdapter
Интерстициальный IMobileAdapter
Родной GADMediationAdapterIMobile

Вот коды ошибок и соответствующие сообщения, которые выдает адаптер i-mobile, когда реклама не загружается:

Android

Код ошибки Причина
0-99 SDK i-mobile вернул ошибку. Подробности см. в коде .
101 Для загрузки рекламы в i-mobile требуется контекст Activity .
102 Параметры сервера i-mobile, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
103 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile.
104 Функция обратного вызова при успешной загрузке нативной рекламы в i-mobile вернула пустой список нативных объявлений.

iOS

Код ошибки Причина
0-10 SDK i-mobile вернул ошибку. Подробности см. в коде .
101 Параметры сервера i-mobile, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
102 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile.
103 i-mobile не удалось показать рекламу.
104 i-mobile вернул пустой массив нативных рекламных объявлений.
105 i-mobile не удалось загрузить рекламные материалы.
106 i-mobile не поддерживает запрос на показ нескольких межстраничных объявлений с использованием одного и того же идентификатора Spot ID.

Список изменений плагина i-mobile Unity Mediation

Версия 1.3.8

Версия 1.3.7

Версия 1.3.6

Версия 1.3.5

Версия 1.3.4

Версия 1.3.3

Версия 1.3.2

Версия 1.3.1

Версия 1.3.0

Версия 1.2.2

Версия 1.2.1

Версия 1.2.0

Версия 1.1.0

Версия 1.0.2

Версия 1.0.1

Версия 1.0.0