В этом руководстве рассказывается, как с помощью Google Mobile Ads SDK загружать и показывать объявления из i-mobile, используя медиацию AdMob, в том числе каскадную интеграцию. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать i-mobile SDK и адаптер в приложение для iOS.
В интерфейсе панели управления i-mobile для ярлыков, кнопок и описаний используется японский язык. Скриншоты в этом руководстве не переведены. В описаниях и инструкциях этого руководства названия кнопок и ярлыков переведены на русский язык, а в скобках указаны их английские эквиваленты.
Поддерживаемые интеграции и форматы объявлений
Адаптер для медиации i-mobile поддерживает следующие функции:
| Интеграция | |
|---|---|
| Ставки | |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничное объявление | |
| Бонус предоставлен | |
| Стандартное | |
Требования
Прежде чем продолжить, убедитесь, что:
- Целевая версия iOS – 13.0 или более поздняя.
Последняя версия Google Mobile Ads SDK.
Шаг 1. Настройте конфигурации в интерфейсе i-mobile
Зарегистрируйтесь или войдите в аккаунт i-mobile.
Добавьте приложение на панель управления i-mobile, нажав на вкладку サイト/アプリ管理 (Управление сайтами и приложениями) и кнопку для платформы вашего приложения.
Заполните форму и нажмите кнопку 新規登録 (Зарегистрироваться).
Чтобы создать новое рекламное место, выберите приложение на вкладке サイト/アプリ管理 (Управление сайтами и приложениями).
Перейдите на вкладку 広告スポット管理 (Управление рекламными местами) и нажмите кнопку 新規広告スポット (Новое рекламное место).
Затем заполните форму, указав 広告スポット名 (Название рекламного места), 広告スポットサイズ (Размер рекламного места) и другие сведения. Затем нажмите кнопку 新規登録 (Зарегистрироваться).
Ваша новая рекламная вставка готова. Чтобы посмотреть сведения об интеграции, нажмите кнопку アプリ設定取得 (Получить настройки приложения).
Запишите идентификатор издателя, идентификатор медиаконтента и идентификатор места размещения. Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.
Как обновить файл app-ads.txt
Authorized Sellers for Apps (Авторизованные продавцы приложений), или app-ads.txt, – это инициатива IAB Tech Lab, которая позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt.
Если вы ещё этого не сделали, настройте файл app-ads.txt для приложения.
Чтобы реализовать app-ads.txt для i-mobile, ознакомьтесь с часто задаваемыми вопросами.
Шаг 2. Настройте источник спроса i-mobile в интерфейсе AdMob
Как настроить медиацию для рекламного блока
Вам нужно добавить i-mobile в конфигурацию медиации для рекламного блока.
Войдите в аккаунт AdMob. Затем перейдите на вкладку Медиация. Если у вас уже есть группа медиации, которую вы хотите изменить, нажмите на ее название и перейдите к разделу Как добавить i-mobile в качестве источника объявлений.
Чтобы создать новую группу медиации, нажмите Создать группу медиации.

Укажите формат и платформу объявления и нажмите Продолжить.

Укажите название группы медиации и выберите целевые местоположения. Затем установите для группы медиации статус Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово.

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить i-mobile в качестве источника объявлений
На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.
Выберите i-mobile и включите переключатель Оптимизировать. Введите имя пользователя и пароль API, полученные в предыдущем разделе, чтобы настроить оптимизацию источника объявлений для i-mobile. Затем введите эффективную цену за тысячу показов для i-mobile и нажмите Продолжить.

Если у вас уже есть сопоставление для i-mobile, выберите его. В противном случае нажмите Добавить сопоставление.

Затем введите идентификатор издателя, идентификатор медиаконтента и идентификатор рекламного места, полученные в предыдущем разделе. Затем нажмите Готово.

Шаг 3. Импортируйте i-mobile SDK и адаптер
Как использовать Swift Package Manager
Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера 2.3.4.2.
Чтобы добавить зависимость пакета в проект, выполните следующие действия:
В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне введите следующий URL пакета:
https://github.com/googleads/googleads-mobile-ios-mediation-imobile.gitВ разделе Правило зависимостей выберите Ветвь.
В текстовом поле введите
main.
Через CocoaPods
Добавьте в Podfile проекта следующую строку:
pod 'GoogleMobileAdsMediationIMobile'В командной строке выполните следующую команду:
pod install --repo-update
Настраиваемые вручную интеграции
- Скачайте последнюю версию i-mobile SDK и добавьте ссылку
ImobileSdkAds.frameworkв свой проект. - Скачайте последнюю версию адаптера i-mobile по ссылке в разделе Changelog и добавьте ссылку
IMobileAdapter.frameworkв свой проект.
Шаг 4. Добавьте обязательный код
Как реализовать SKAdNetwork
Следуйте инструкциям i-mobile, чтобы добавить идентификаторы SKAdNetwork в файл Info.plist проекта.
Шаг 5. Проверьте реализацию
Как включить тестовые объявления
Зарегистрируйте тестовое устройство в AdMob. i-mobile предоставляет тестовые идентификаторы рекламных мест, идентификаторы мультимедийных объектов и идентификаторы издателей. Их можно найти здесь.
Как проверить тестовые объявления
Чтобы проверить, получаете ли вы тестовые объявления от i-mobile, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источник объявлений i-mobile (каскад).
Необязательные действия
Использование нативных объявлений
Отображение объявлений
Адаптер i-mobile заполняет следующие описания полей расширенных нативных объявлений для GADNativeAd.
| Поле | Объекты, которые всегда добавляются адаптером i-mobile |
|---|---|
| Заголовок | |
| Изображение | |
| Body | |
| Значок приложения | 1 |
| Призыв к действию | |
| Star rating | |
| Магазин | |
| Цена |
1 Для нативных объявлений в i-mobile SDK нет объекта значка приложения. Вместо этого адаптер i-mobile заполняет значок приложения прозрачным изображением.
Коды ошибок
Если адаптер не может получить объявление от i-mobile, издатели могут проверить основную ошибку в ответе на запрос объявления с помощью GADResponseInfo.adNetworkInfoArray в следующих классах:
| Формат | Название класса |
|---|---|
| Баннер | IMobileAdapter |
| Межстраничное объявление | IMobileAdapter |
| Стандартное | GADMediationAdapterIMobile |
Ниже приведены коды и сообщения, которые адаптер i-mobile возвращает, когда не удается загрузить объявление:
| Код ошибки | Причина |
|---|---|
| 0-10 | SDK i-mobile вернул ошибку. Подробнее о коде… |
| 101 | Параметры сервера i-mobile, настроенные в интерфейсе AdMob, отсутствуют или являются недействительными. |
| 102 | Запрошенный размер объявления не соответствует поддерживаемому i-mobile размеру баннера. |
| 103 | Не удалось показать объявление i-mobile. |
| 104 | i-mobile вернул пустой массив нативных объявлений. |
| 105 | i-mobile не удалось скачать объекты нативного объявления. |
| 106 | i-mobile не поддерживает запросы на несколько объявлений-заставок с одним и тем же идентификатором места размещения. |
| 107 | Фильтрация запросов с возрастными ограничениями для i-mobile SDK, поскольку он не может получать сигналы с возрастными ограничениями. |
История изменений адаптера для медиации i-mobile для iOS
Версия 2.3.4.8
- Минимальная версия iOS была обновлена, чтобы ослабить зависимость Google Mobile Ads SDK и разрешить промежуточные версии.
Создано и протестировано с использованием:
- Google Mobile Ads SDK версии 13.7.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.4.7
- Фильтрация запросов с возрастными ограничениями для i-mobile SDK, когда для параметра
ageRestrictedTreatmentзадано значениеGADAgeRestrictedTreatmentChild.
Создано и протестировано с использованием:
- Google Mobile Ads SDK версии 13.4.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.4.6
- Фильтрация запросов с возрастными ограничениями для i-mobile SDK, поскольку он не может получать сигналы с возрастными ограничениями.
Создано и протестировано с использованием:
- Google Mobile Ads SDK версии 13.2.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.4.5
- Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.
Создано и протестировано с использованием:
- Google Mobile Ads SDK версии 13.0.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.4.4
- Минимальная версия iOS для CocoaPods теперь
13.0.
Создано и протестировано с использованием:
- Google Mobile Ads SDK версии 13.0.0.
- i-mobile SDK версии 2.3.4.
Версия 2.3.4.3
- Исправлены названия фреймворка и зонтичного заголовка в файле
IMobileAdaptermodulemap.
Создано и протестировано с использованием:
- Google Mobile Ads SDK версии 12.12.0.
- i-mobile SDK версии 2.3.4.
Версия 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.
- Добавлена поддержка возврата версии 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
- Добавлены стандартизированные коды ошибок и сообщения адаптера.
- Адаптер теперь ограничивает запросы нескольких межстраничных объявлений с использованием одного и того же идентификатора места размещения 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.