В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы с i-mobile с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока, а также как интегрировать i-mobile SDK и адаптер в приложение iOS.
Интерфейс приборной панели i-Mobile использует японский текст для надписей, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки переведены, а их эквиваленты на английском языке указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер-посредник для i-mobile имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Интерстициальный | |
Награжден | |
Родной |
Требования
- Цель развертывания iOS 12.0 или выше
Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.
Шаг 1: Настройте конфигурации в пользовательском интерфейсе i-mobile
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト/アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.

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

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

Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе Менеджера рекламы.

Обновите файл app-ads.txt
Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь в приложении будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt
. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы .
Чтобы реализовать app-ads.txt
для i-mobile, ознакомьтесь с разделом «Часто задаваемые вопросы» .
Шаг 2: Настройте спрос на i-mobile в пользовательском интерфейсе Менеджера рекламы
Настройте параметры медиации для вашего рекламного блока
Войдите в свою учетную запись Менеджера рекламы .
Перейдите в раздел Доставка > Группы доходности и нажмите кнопку Новая группа доходности .
Введите уникальное название для группы доходности, установите статус « Активно» , выберите формат рекламы и тип инвентаря «Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь» и «Мобильное приложение» , к которому вы хотите добавить медиацию.
Затем нажмите кнопку Добавить партнера по доходности .
Если у вас уже есть партнёр по доходности для i-mobile, вы можете выбрать его. В противном случае выберите «Создать нового партнёра по доходности» .
Выберите i-mobile в качестве рекламной сети , введите уникальное имя и включите посредничество .
Включите автоматический сбор данных и введите имя пользователя и пароль API.
После выбора партнёра по Yield выберите Mobile SDK Mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса . Введите идентификатор издателя , идентификатор медиа и идентификатор точки, полученные в предыдущем разделе. Затем укажите значение CPM по умолчанию .
По завершении нажмите кнопку «Сохранить» внизу страницы.
Шаг 3: Импортируйте i-mobile SDK и адаптер
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в Podfile вашего проекта:
pod 'GoogleMobileAdsMediationIMobile'
В командной строке выполните:
pod install --repo-update
Ручная интеграция
- Загрузите последнюю версию i-mobile SDK и подключите
ImobileSdkAds.framework
к своему проекту. - Загрузите последнюю версию адаптера i-Mobile по ссылке в журнале изменений и добавьте
IMobileAdapter.framework
в свой проект.
Шаг 4: Добавьте необходимый код
Интеграция SKAdNetwork
Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Менеджере рекламы. i-mobile предоставляет тестовые идентификаторы Spot ID , Media ID и Publisher ID для тестирования, вы можете найти их здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений i-mobile (Waterfall ).
Дополнительные шаги
Использование нативной рекламы
Рендеринг рекламы
Адаптер i-mobile заполняет следующие поля для GADNativeAd
.
Поле | Активы всегда включены адаптером i-mobile |
---|---|
Заголовок | |
Изображение | |
Тело | |
Значок приложения | 1 |
Призыв к действию | |
Звездный рейтинг | |
Магазин | |
Цена |
1 Для нативной рекламы i-mobile SDK не предоставляет ресурс значка приложения. Вместо этого адаптер i-mobile заполняет значок приложения прозрачным изображением.
Коды ошибок
Если адаптеру не удается получить рекламу от i-mobile, издатели могут проверить основную ошибку в ответе на рекламу, используя GADResponseInfo.adNetworkInfoArray
в следующих классах:
Формат | Имя класса |
---|---|
Баннер | iMobileAdapter |
Интерстициальный | iMobileAdapter |
Родной | GADMediationAdapterIMobile |
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-Mobile, когда реклама не загружается:
Код ошибки | Причина |
---|---|
0-10 | i-mobile SDK вернул ошибку. Подробнее см. в коде . |
101 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют/недействительны. |
102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. |
103 | i-mobile не смог показать рекламу. |
104 | i-mobile вернул пустой массив собственных объявлений. |
105 | i-mobile не удалось загрузить собственные рекламные ресурсы. |
106 | i-mobile не поддерживает запрос нескольких полноэкранных объявлений с использованием одного и того же идентификатора Spot ID. |
Журнал изменений адаптера-посредника iOS i-mobile
Следующая версия
- Включите -fobjc-arc и -fstack-protector-all.
Версия 2.3.4.2
- Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 12.0.0.
- i-mobile SDK версии 2.3.4.
Версия 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.
- Добавлена поддержка возврата версии SDK i-mobile в
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
- Добавлены стандартизированные коды ошибок адаптера и сообщения.
- Адаптер теперь ограничивает запрос нескольких полноэкранных объявлений с использованием одного и того же идентификатора i-mobile Spot ID.
- Адаптер теперь пересылает обратный вызов
-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 или выше.
- Добавлена поддержка масштабирования объявлений размером 320x50 и 320x100 для лучшего соответствия размерам запросов адаптивных баннеров.
- Удалена поддержка архитектуры 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.