Как интегрировать i-mobile с медиацией

В этом руководстве рассказывается, как с помощью Google Mobile Ads SDK загружать и показывать объявления из i-mobile, используя медиацию AdMob, в том числе каскадную интеграцию. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать i-mobile SDK и адаптер в приложение для iOS.

В интерфейсе панели управления i-mobile для ярлыков, кнопок и описаний используется японский язык. Скриншоты в этом руководстве не переведены. В описаниях и инструкциях этого руководства названия кнопок и ярлыков переведены на русский язык, а в скобках указаны их английские эквиваленты.

Поддерживаемые интеграции и форматы объявлений

Адаптер для медиации i-mobile поддерживает следующие функции:

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

  • Целевая версия iOS – 13.0 или более поздняя.

Шаг 1. Настройте конфигурации в интерфейсе i-mobile

Зарегистрируйтесь или войдите в аккаунт i-mobile.

Добавьте приложение на панель управления i-mobile, нажав на вкладку サイト/アプリ管理 (Управление сайтами и приложениями) и кнопку для платформы вашего приложения.

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

Чтобы создать новое рекламное место, выберите приложение на вкладке サイト/アプリ管理 (Управление сайтами и приложениями).

Перейдите на вкладку 広告スポット管理 (Управление рекламными местами) и нажмите кнопку 新規広告スポット (Новое рекламное место).

create_ad_spot

Затем заполните форму, указав 広告スポット名 (Название рекламного места), 広告スポットサイズ (Размер рекламного места) и другие сведения. Затем нажмите кнопку 新規登録 (Зарегистрироваться).

new_ad_spot_form

Ваша новая рекламная вставка готова. Чтобы посмотреть сведения об интеграции, нажмите кнопку アプリ設定取得 (Получить настройки приложения).

ad_spot_list

Запишите идентификатор издателя, идентификатор медиаконтента и идентификатор места размещения. Эти параметры понадобятся вам позже при настройке 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.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

  1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

  2. В появившемся окне введите следующий URL пакета:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git
    
  3. В разделе Правило зависимостей выберите Ветвь.

  4. В текстовом поле введите 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

  • Исправлены названия фреймворка и зонтичного заголовка в файле IMobileAdapter modulemap.

Создано и протестировано с использованием:

  • 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.