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

В этом руководстве рассказывается, как Google Mobile Ads SDKзагружать и показывать объявления из i-mobile с помощью медиации, используя каскадную интеграцию. В нем рассказывается, как добавить 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 для медиации в интерфейсе Менеджера рекламы.

Как обновить файл 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 в интерфейсе Менеджера рекламы

Как настроить медиацию для рекламного блока

Войдите в аккаунт Менеджера рекламы.

Откройте раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности.

Укажите уникальное название группы доходности, задайте Статус Активный, выберите Формат объявлений и задайте Тип инвентаря Мобильное приложение. В разделе Таргетинг > Инвентарь выберите рекламный блок в разделе Инвентарь и Мобильное приложение, в который вы хотите добавить медиацию.

Затем нажмите кнопку Добавить партнера по группе доходности.

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

Выберите i-mobile в качестве рекламной сети, введите уникальное название и включите медиацию.

Включите Автоматический сбор данных и введите имя пользователя и пароль API.

После того как вы выберете партнера по группе доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, iOS в качестве платформы и Активно в качестве статуса. Введите идентификатор издателя, идентификатор медиаконтента и идентификатор рекламного места, полученные в предыдущем разделе. Затем введите стандартную цену за тысячу показов.

Нажмите Сохранить внизу страницы.

Шаг 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. Проверьте реализацию

Как включить тестовые объявления

Зарегистрируйте тестовое устройство в Менеджере рекламы. 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, настроенные в интерфейсе Менеджера рекламы, отсутствуют или являются недействительными.
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.