Интегрируйте i-mobile с медиацией

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

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Требования

  • Цель развертывания iOS 12.0 или выше

Шаг 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 для Ad Manager .

Чтобы реализовать app-ads.txt для i-mobile, ознакомьтесь с разделом «Часто задаваемые вопросы» .

Шаг 2: Настройте спрос на мобильные устройства в пользовательском интерфейсе Менеджера объявлений

Настройте параметры медиации для вашего рекламного блока

Войдите в свою учетную запись Менеджера рекламы .

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

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

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

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

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

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

После выбора партнера Yield выберите Mobile SDK Mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса . Введите идентификатор издателя , идентификатор носителя и идентификатор пятна, полученные в предыдущем разделе. Затем введите значение CPM по умолчанию .

По завершении нажмите кнопку «Сохранить» в нижней части страницы.

Шаг 3: Импортируйте i-mobile SDK и адаптер

Добавьте следующую строку в Podfile вашего проекта:

pod 'GoogleMobileAdsMediationIMobile'

В командной строке выполните:

pod install --repo-update

Ручная интеграция

  • Загрузите последнюю версию i-mobile SDK и добавьте ImobileSdkAds.framework в свой проект.
  • Загрузите последнюю версию адаптера i-mobile по ссылке в журнале изменений и добавьте IMobileAdapter.framework в свой проект.

Шаг 4: Добавьте требуемый код

Интеграция SKAdNetwork

Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

Шаг 5: Проверьте свою реализацию

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager. 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 Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile.
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.
  • Адаптер теперь пересылает обратный вызов -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.