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

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

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

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

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

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

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

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

ad_spot_list

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

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

Файл 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.

После выбора партнёра по 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: Проверьте свою реализацию

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

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