Интегрируйте 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, щелкнув вкладку «サイト/アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.

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

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

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

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

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

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

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

ad_spot_list

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

Обновите файл app-ads.txt

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

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

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

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

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

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

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

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

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

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

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

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


На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

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



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

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

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