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

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

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

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

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

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

Требования

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

Шаг 1: Настройка конфигураций в пользовательском интерфейсе i-mobile

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

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

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

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

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

создать_рекламное_место

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

новая_рекламная_форма

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

список_рекламных_мест

Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор Spot) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.

Обновите свой app-ads.txt

Авторизованные продавцы приложений app-ads.txt — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь приложения продается только через каналы, которые вы определили как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам нужно будет внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

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

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

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

Вам необходимо добавить i-mobile в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку Медиация . Если у вас есть существующая группа медиации, которую вы хотите изменить, щелкните имя этой группы медиации, чтобы отредактировать ее, и перейдите к разделу Добавить i-mobile как источник рекламы .

Чтобы создать новую группу посредничества, выберите «Создать группу посредничества» .

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавить i-mobile как источник рекламы


Под карточкой Waterfall в разделе Ad Sources выберите Add Ad Source . Затем выберите i-mobile .

Выберите i-mobile и включите переключатель Optimize . Введите имя пользователя и пароль API, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для i-mobile. Затем введите значение eCPM для i-mobile и нажмите Continue .



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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob. 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, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
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.