В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы с i-mobile с помощью AdMob Mediation , а также рассматривается каскадная интеграция. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер i-mobile в приложение iOS.
Интерфейс информационной панели i-mobile использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для i-mobile имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Родной |
Требования
- Цель развертывания iOS 12.0 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе i-mobile.
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト/アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .
Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.
Шаг 2. Настройте спрос на мобильные устройства в интерфейсе AdMob.
Настройте параметры медиации для своего рекламного блока
Вам необходимо добавить i-mobile в конфигурацию медиации для вашего рекламного блока.
Сначала войдите в свою учетную запись AdMob . Далее перейдите на вкладку «Медиация» . Если у вас есть существующая группа медиации, которую вы хотите изменить, нажмите на название этой группы медиации, чтобы изменить ее, и перейдите к пункту «Добавить i-mobile в качестве источника объявлений» .
Чтобы создать новую группу медиации, выберите Создать группу медиации .
Введите формат объявления и платформу, затем нажмите «Продолжить» .
Дайте группе медиации название и выберите целевые местоположения. Затем установите статус группы медиации на «Включено » и нажмите «Добавить рекламные блоки» .
Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .
Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:
Добавьте i-mobile в качестве источника рекламы
Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите i-mobile .
Выберите i-mobile и включите переключатель «Оптимизировать» . Введите имя для входа и пароль API, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для i-mobile. Затем введите значение эффективной цены за тысячу показов для i-mobile и нажмите «Продолжить» .
Если у вас уже есть карта для i-mobile, вы можете выбрать ее. В противном случае нажмите «Добавить сопоставление» .
Затем введите идентификатор издателя , идентификатор носителя и идентификатор Spot, полученные в предыдущем разделе. Затем нажмите Готово .
Шаг 3. Импортируйте SDK и адаптер i-mobile.
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в подфайл вашего проекта:
pod 'GoogleMobileAdsMediationIMobile'
Из командной строки выполните:
pod install --repo-update
Ручная интеграция
- Загрузите последнюю версию i-mobile SDK и свяжите
ImobileSdkAds.framework
в своем проекте. - Загрузите последнюю версию адаптера i-mobile по ссылке в журнале изменений и свяжите
IMobileAdapter.framework
в своем проекте.
Шаг 4. Добавьте необходимый код
Интеграция со SKAdNetwork
Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в AdMob. i-mobile предоставляет для тестирования идентификатор тестовой точки , идентификатор носителя и идентификатор издателя . Их можно найти здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений i-mobile (Waterfall) .
Дополнительные шаги
Использование нативной рекламы
Рендеринг рекламы
Адаптер i-mobile заполняет следующие описания дополнительных полей нативной рекламы для GADNativeAd
.
Поле | Ресурсы, всегда включенные в адаптер i-mobile |
---|---|
Заголовок | |
Изображение | |
Тело | |
Значок приложения | 1 |
Призыв к действию | |
Звездный рейтинг | |
Магазин | |
Цена |
1 Для нативной рекламы i-mobile SDK не предоставляет значок приложения. Вместо этого адаптер i-mobile заполняет значок приложения прозрачным изображением.
Коды ошибок
Если адаптеру не удается получить рекламу от i-mobile, издатели могут проверить основную ошибку из ответа на объявление, используя GADResponseInfo.adNetworkInfoArray
в следующих классах:
Формат | Имя класса |
---|---|
Баннер | IMobileАдаптер |
Межстраничный | IMobileАдаптер |
Родной | GADMediationAdapterIMobile |
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-mobile, когда реклама не загружается:
Код ошибки | Причина |
---|---|
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. |
Журнал изменений адаптера медиации i-mobile iOS
Версия 2.3.4.1
- Обновлен
CFBundleShortVersionString
, чтобы иметь три компонента вместо четырех.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.10.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.4.0
- Проверенная совместимость с i-mobile SDK 2.3.4.
- Добавлена поддержка возврата версии i-mobile SDK в
adSDKVersion
.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.2.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.3.0
- Проверенная совместимость с i-mobile SDK 2.3.3.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.1.0.
- i-mobile SDK версии 2.3.3.
Версия 2.3.2.1
- Удален устаревший метод делегата
willBackgroundApplication
из реализаций баннеров, межстраничных и собственных объявлений. - Теперь требуется минимальная версия iOS 12.0.
- Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
-
Info.plist
включен в рамкиIMobileAdapter.xcframework
.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 11.0.1.
- i-mobile SDK версии 2.3.2.
Версия 2.3.2.0
- Проверенная совместимость с i-mobile SDK 2.3.2.
- Удалена поддержка архитектуры
armv7
. - Теперь требуется минимальная версия iOS 11.0.
- Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.4.0.
- i-mobile SDK версии 2.3.2.
Версия 2.3.1.0
- Проверенная совместимость с i-mobile SDK 2.3.1.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.3.0.
- i-mobile SDK версии 2.3.1.
Версия 2.3.0.1
- Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 10.0.0.
- i-mobile SDK версии 2.3.0.
Версия 2.3.0.0
- Проверенная совместимость с i-mobile SDK 2.3.0.
- Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.13.0.
- i-mobile SDK версии 2.3.0.
Версия 2.2.0.1
- Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 9.0.0.
- i-mobile SDK версии 2.2.0.
Версия 2.2.0.0
- Проверенная совместимость с i-mobile SDK версии 2.2.0.
Создан и протестирован с
- Google Mobile Ads SDK версии 8.13.0.
- i-mobile SDK версии 2.2.0.
Версия 2.1.0.1
- Слабая зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.
Создан и протестирован с
- Google Mobile Ads SDK версии 8.4.0.
- i-mobile SDK версии 2.1.0.
Версия 2.1.0.0
- Проверенная совместимость с i-mobile SDK версии 2.1.0.
- Теперь требуется Google Mobile Ads SDK версии 8.1.0 или выше.
- Обновлен адаптер для использования формата
.xcframework
.
Создан и протестирован с
- Google Mobile Ads SDK версии 8.1.0.
- i-mobile SDK версии 2.1.0.
Версия 2.0.33.1
- Добавлены стандартизированные коды ошибок и сообщения адаптера.
- Адаптер теперь ограничивает запрос нескольких межстраничных объявлений с использованием одного и того же идентификатора Spot ID i-mobile.
- Адаптер теперь перенаправляет обратный вызов
-nativeAdWillLeaveApplication:
при нажатии нативной рекламы. - Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.
Создан и протестирован с
- Google Mobile Ads SDK версии 7.68.0.
- i-mobile SDK версии 2.0.33.
Версия 2.0.33.0
- Проверенная совместимость с i-mobile SDK версии 2.0.33.
- Теперь требуется Google Mobile Ads SDK версии 7.65.0 или выше.
- Теперь требуется минимальная версия iOS 9.0.
Создан и протестирован с
- Google Mobile Ads SDK версии 7.65.0.
- i-mobile SDK версии 2.0.33.
Версия 2.0.32.0
- Проверенная совместимость с i-mobile SDK версии 2.0.32.
- Теперь требуется Google Mobile Ads SDK версии 7.60.0 или выше.
- Добавлена поддержка масштабирования объявлений 320 x 50 и 320 x 100 для лучшего соответствия размерам запроса адаптивного баннера.
- Удалена поддержка архитектуры i386.
Создан и протестирован с
- Google Mobile Ads SDK версии 7.60.0.
- i-mobile SDK версии 2.0.32.
Версия 2.0.31.0
- Проверенная совместимость с i-mobile SDK версии 2.0.31.
Создан и протестирован с
- Google Mobile Ads SDK версии 7.53.1.
- i-mobile SDK версии 2.0.31.
Версия 2.0.29.0
- Первый выпуск!
- Добавлена поддержка баннерной, межстраничной и нативной рекламы.
Создан и протестирован с
- Google Mobile Ads SDK версии 7.52.0.
- i-mobile SDK версии 2.0.29.