В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из i-mobile с помощью медиации , а также каскадная интеграция. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер i-mobile в приложение Unity.
Интерфейс информационной панели i-mobile использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер-посредник для i-mobile имеет следующие возможности:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничный | |
| Награжден | |
Требования
- Unity 5.6 или выше
- Последняя версия Google Mobile Ads SDK
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе i-mobile.
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Андроид
iOS
Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .
Андроид
iOS
Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Андроид
iOS
Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор Spot) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.
Андроид
iOS
Шаг 2. Настройте спрос на i-mobile в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3. Импортируйте i-mobile SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин медиации Google Mobile Ads i-mobile для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.imobile
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM - URL-адрес:
https://package.openupm.com. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads i-mobile Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина-посредника Google Mobile Ads для i-mobile по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsIMobileMediation.unitypackage из ZIP-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsIMobileMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.
Шаг 4. Требуется дополнительный код.
Андроид
Никакого дополнительного кода не требуется для интеграции i-mobile.
iOS
Интеграция со SKAdNetwork
Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob. i-mobile предоставляет для тестирования идентификатор тестовой точки , идентификатор носителя и идентификатор издателя . Их можно найти здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от 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
| Формат | Имя класса |
|---|---|
| Баннер | IMobileАдаптер |
| Межстраничный | IMobileАдаптер |
| Родной | GADMediationAdapterIMobile |
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-mobile, когда реклама не загружается:
Андроид
| Код ошибки | Причина |
|---|---|
| 0-99 | i-mobile SDK вернул ошибку. Более подробную информацию смотрите в коде . |
| 101 | i-mobile требует контекста Activity для загрузки рекламы. |
| 102 | параметры сервера i-mobile, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
| 103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile. |
| 104 | Обратный вызов при успешной загрузке встроенной рекламы i-mobile вернул пустой список встроенной рекламы. |
iOS
| Код ошибки | Причина |
|---|---|
| 0-10 | i-mobile SDK вернул ошибку. Более подробную информацию смотрите в коде . |
| 101 | параметры сервера i-mobile, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
| 102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile. |
| 103 | i-mobile не смог показать объявление. |
| 104 | i-mobile вернул пустой массив собственных объявлений. |
| 105 | i-mobile не удалось загрузить собственные рекламные ресурсы. |
| 106 | i-mobile не поддерживает запрос нескольких межстраничных объявлений с использованием одного и того же Spot ID. |
Журнал изменений плагина Unity Mediation для i-mobile
Версия 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 .
- Поддерживает адаптер i-mobile iOS версии 2.3.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.3.4
- Поддерживает адаптер Android i-mobile версии 2.3.1.2 .
- Поддерживает адаптер i-mobile iOS версии 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/. - Поддерживает адаптер i-mobile Android версии 2.3.1.1 .
- Поддерживает адаптер i-mobile iOS версии 2.3.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 1.3.1
- Поддерживает адаптер i-mobile Android версии 2.3.0.0 .
- Поддерживает адаптер i-mobile iOS версии 2.3.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 1.3.0
- Поддерживает адаптер i-mobile Android версии 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 .
- Поддерживает адаптер i-mobile iOS версии 2.2.0.0 .
Версия 1.1.0
- Поддерживает адаптер i-mobile Android версии 2.0.22.2 .
- Поддерживает адаптер i-mobile iOS версии 2.1.0.1 .
Версия 1.0.2
- Поддерживает адаптер Android i-mobile версии 2.0.22.0 .
- Поддерживает адаптер iOS i-mobile версии 2.0.32.0 .
Версия 1.0.1
- Поддерживает адаптер i-mobile Android версии 2.0.21.0 .
- Поддерживает адаптер iOS i-mobile версии 2.0.31.0 .
Версия 1.0.0
- Первый выпуск!
- Поддерживает адаптер i-mobile Android версии 2.0.20.1 .
- Поддерживает адаптер i-mobile iOS версии 2.0.29.0 .
В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из i-mobile с помощью медиации , а также каскадная интеграция. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер i-mobile в приложение Unity.
Интерфейс информационной панели i-mobile использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы объявлений
AdMob Адаптер-посредник для i-mobile имеет следующие возможности:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничный | |
| Награжден | |
Требования
- Unity 5.6 или выше
- Последняя версия Google Mobile Ads SDK
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе i-mobile.
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Андроид
iOS
Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .
Андроид
iOS
Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Андроид
iOS
Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор Spot) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.
Андроид
iOS
Шаг 2. Настройте спрос на i-mobile в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3. Импортируйте i-mobile SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин медиации Google Mobile Ads i-mobile для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.imobile
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM - URL-адрес:
https://package.openupm.com. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads i-mobile Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина-посредника Google Mobile Ads для i-mobile по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsIMobileMediation.unitypackage из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsIMobileMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.
Шаг 4. Требуется дополнительный код.
Андроид
Никакого дополнительного кода не требуется для интеграции i-mobile.
iOS
Интеграция со SKAdNetwork
Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob. i-mobile предоставляет для тестирования идентификатор тестовой точки , идентификатор носителя и идентификатор издателя . Их можно найти здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от 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
| Формат | Имя класса |
|---|---|
| Баннер | IMobileАдаптер |
| Межстраничный | IMobileАдаптер |
| Родной | GADMediationAdapterIMobile |
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-mobile, когда реклама не загружается:
Андроид
| Код ошибки | Причина |
|---|---|
| 0-99 | i-mobile SDK вернул ошибку. Более подробную информацию смотрите в коде . |
| 101 | i-mobile требует контекста Activity для загрузки рекламы. |
| 102 | параметры сервера i-mobile, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
| 103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile. |
| 104 | Обратный вызов при успешной загрузке встроенной рекламы i-mobile вернул пустой список встроенной рекламы. |
iOS
| Код ошибки | Причина |
|---|---|
| 0-10 | i-mobile SDK вернул ошибку. Более подробную информацию смотрите в коде . |
| 101 | параметры сервера i-mobile, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен. |
| 102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile. |
| 103 | i-mobile не смог показать объявление. |
| 104 | i-mobile вернул пустой массив собственных объявлений. |
| 105 | i-mobile не удалось загрузить собственные рекламные ресурсы. |
| 106 | i-mobile не поддерживает запрос нескольких межстраничных объявлений с использованием одного и того же Spot ID. |
Журнал изменений плагина Unity Mediation для i-mobile
Версия 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
- Поддерживает адаптер i-mobile Android версии 2.3.2.0 .
- Поддерживает адаптер i-mobile iOS версии 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/. - Поддерживает адаптер i-mobile Android версии 2.3.1.1 .
- Поддерживает адаптер iOS i-mobile версии 2.3.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 1.3.1
- Поддерживает адаптер i-mobile Android версии 2.3.0.0 .
- Поддерживает адаптер iOS i-mobile версии 2.3.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 1.3.0
- Поддерживает адаптер i-mobile Android версии 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 .
- Поддерживает адаптер i-mobile iOS версии 2.2.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 1.2.1
- Поддерживает адаптер Android i-mobile версии 2.0.23.0 .
- Поддерживает адаптер i-mobile iOS версии 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 .
- Поддерживает адаптер i-mobile iOS версии 2.1.0.1 .
Версия 1.0.2
- Поддерживает адаптер i-mobile Android версии 2.0.22.0 .
- Поддерживает адаптер iOS i-mobile версии 2.0.32.0 .
Версия 1.0.1
- Поддерживает адаптер i-mobile Android версии 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 .