В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы с i-mobile с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока, а также как интегрировать i-mobile SDK и адаптер в приложение Unity.
Интерфейс приборной панели i-Mobile использует японский текст для надписей, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки переведены, а их эквиваленты на английском языке указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер-медиатор AdMob для i-mobile обладает следующими возможностями:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден |
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 5.6 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Завершить посредничество . Руководство по началу работы.
Шаг 1: Настройте конфигурации в пользовательском интерфейсе i-mobile
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト/アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Андроид
iOS
Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .
Андроид
iOS
Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Андроид
iOS
Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.
Андроид
iOS
Обновите файл app-ads.txt
Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt
. Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .
Чтобы реализовать app-ads.txt
для i-mobile, ознакомьтесь с разделом «Часто задаваемые вопросы» .
Шаг 2: Настройте спрос на мобильные устройства в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3: Импортируйте i-mobile SDK и адаптер
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads i-mobile Mediation Plugin для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .
На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
- Область(ы):
com.google
Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.
Выберите пакет Google Mobile Ads iMobile Mediation и нажмите «Установить» .
Пакет Unity
Загрузите последнюю версию плагина медиации Google Mobile Ads для i-Mobile по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsIMobileMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsIMobileMediation.unitypackage
. Убедитесь, что выбраны все файлы, и нажмите «Импорт» .
Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4: требуется дополнительный код
Андроид
Для интеграции с iMobile не требуется дополнительный код.
iOS
Интеграция SKAdNetwork
Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob. i-mobile предоставляет тестовые Spot ID , Media ID и Publisher ID для тестирования, вы можете найти их здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений i-mobile (Waterfall ).
Коды ошибок
Если адаптеру не удается получить рекламу от i-mobile, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo
в следующих классах:
Андроид
Формат | Имя класса |
---|---|
Баннер | com.google.ads.mediation.imobile.IMobileAdapter |
Интерстициальный | com.google.ads.mediation.imobile.IMobileAdapter |
Родной | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
Формат | Имя класса |
---|---|
Баннер | iMobileAdapter |
Интерстициальный | iMobileAdapter |
Родной | GADMediationAdapterIMobile |
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-Mobile, когда реклама не загружается:
Андроид
Код ошибки | Причина |
---|---|
0-99 | i-mobile SDK вернул ошибку. Подробнее см. в коде . |
101 | i-mobile требует контекст Activity для загрузки рекламы. |
102 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны. |
103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. |
104 | Обратный вызов i-mobile об успешной загрузке собственной рекламы вернул пустой список собственных объявлений. |
iOS
Код ошибки | Причина |
---|---|
0-10 | i-mobile SDK вернул ошибку. Подробнее см. в коде . |
101 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны. |
102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. |
103 | i-mobile не смог показать рекламу. |
104 | i-mobile вернул пустой массив собственных объявлений. |
105 | i-mobile не удалось загрузить собственные рекламные ресурсы. |
106 | i-mobile не поддерживает запрос нескольких полноэкранных объявлений с использованием одного и того же идентификатора Spot ID. |
Журнал изменений плагина Unity Mediation для i-mobile
Версия 1.3.7
- Поддерживает Android-адаптер i-mobile версии 2.3.2.1 .
- Поддерживает адаптер iOS i-mobile версии 2.3.4.2 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.0.0.
Версия 1.3.6
- Поддерживает Android-адаптер i-mobile версии 2.3.2.0 .
- Поддерживает адаптер iOS i-mobile версии 2.3.4.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 1.3.5
- Поддерживает Android-адаптер i-mobile версии 2.3.2.0 .
- Поддерживает адаптер iOS i-mobile версии 2.3.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.3.4
- Поддерживает Android-адаптер i-mobile версии 2.3.1.2 .
- Поддерживает адаптер iOS i-mobile версии 2.3.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.3.3
- Поддерживает Android-адаптер i-mobile версии 2.3.1.1 .
- Поддерживает адаптер iOS i-mobile версии 2.3.3.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.3.2
- Содержимое адаптера перемещено в
GoogleMobileAds/Mediation/IMobile/
. - Поддерживает Android-адаптер i-mobile версии 2.3.1.1 .
- Поддерживает адаптер iOS i-mobile версии 2.3.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 1.3.1
- Поддерживает Android-адаптер i-mobile версии 2.3.0.0 .
- Поддерживает адаптер iOS i-mobile версии 2.3.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 1.3.0
- Поддерживает Android-адаптер i-mobile версии 2.3.0.0 .
- Поддерживает адаптер iOS i-mobile версии 2.3.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 1.2.2
- Поддерживает Android-адаптер i-mobile версии 2.0.23.1 .
- Поддерживает адаптер iOS i-mobile версии 2.2.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 1.2.1
- Поддерживает Android-адаптер i-mobile версии 2.0.23.0 .
- Поддерживает адаптер iOS i-mobile версии 2.2.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 1.2.0
- Поддерживает Android-адаптер i-mobile версии 2.0.23.0 .
- Поддерживает адаптер iOS i-mobile версии 2.2.0.0 .
Версия 1.1.0
- Поддерживает Android-адаптер i-mobile версии 2.0.22.2 .
- Поддерживает адаптер iOS i-mobile версии 2.1.0.1 .
Версия 1.0.2
- Поддерживает Android-адаптер i-mobile версии 2.0.22.0 .
- Поддерживает адаптер iOS i-mobile версии 2.0.32.0 .
Версия 1.0.1
- Поддерживает Android-адаптер i-mobile версии 2.0.21.0 .
- Поддерживает адаптер iOS i-mobile версии 2.0.31.0 .
Версия 1.0.0
- Первый релиз!
- Поддерживает Android-адаптер i-mobile версии 2.0.20.1 .
- Поддерживает адаптер iOS i-mobile версии 2.0.29.0 .