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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

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

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

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

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

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

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

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


Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите i-mobile .

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



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

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

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

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

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 предоставляет для тестирования идентификатор тестовой точки , идентификатор носителя и идентификатор издателя , их можно найти здесь .

Проверьте тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений i-mobile (Waterfall) .

Дополнительные шаги

Использование нативной рекламы

Рендеринг рекламы

Адаптер i-mobile заполняет следующие описания расширенных полей нативной рекламы для GADNativeAd .

Поле Ресурсы, всегда включенные в адаптер i-mobile
Заголовок
Изображение
Тело
Значок приложения 1
Призыв к действию
Звездный рейтинг
Магазин
Цена

1 Для нативной рекламы i-mobile SDK не предоставляет значок приложения. Вместо этого адаптер i-mobile заполняет значок приложения прозрачным изображением.

Коды ошибок

Если адаптеру не удается получить рекламу от i-mobile, издатели могут проверить основную ошибку из ответа на объявление, используя GADResponseInfo.adNetworkInfoArray в следующих классах:

Формат Имя класса
Баннер IMobileАдаптер
Межстраничный IMobileАдаптер
Родной 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.

Журнал изменений адаптера медиации i-mobile iOS

Версия 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

  • Добавлены стандартизированные коды ошибок и сообщения адаптера.
  • Адаптер теперь ограничивает запрос нескольких межстраничных объявлений с использованием одного и того же идентификатора Spot ID 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 или выше.
  • Добавлена ​​поддержка масштабирования объявлений 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.