Как интегрировать i-mobile с медиацией

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

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

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

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

• Целевая версия iOS для развертывания – 13.0 или более поздняя.

• Последняя версия Google Mobile Ads SDK.

• Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе i-mobile

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

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

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

Примечание. Ваша регистрация должна быть одобрена i-mobile. После одобрения вы сможете создать рекламную паузу.

Чтобы создать новое рекламное место, выберите приложение на вкладке サイト／アプリ管理 (Управление сайтами и приложениями).

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

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

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

Запишите идентификатор издателя, идентификатор медиаконтента и идентификатор места размещения. Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе Менеджера рекламы.

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

Authorized Sellers for Apps (Авторизованные продавцы приложений), или 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.

Выбрав партнера по группе доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, iOS в качестве платформы и Активно в качестве статуса. Введите идентификатор издателя, идентификатор медиаконтента и идентификатор рекламного места, полученные в предыдущем разделе. Затем укажите цену за тысячу показов по умолчанию.

Нажмите Сохранить внизу страницы.

Примечание. Чтобы точно рассчитать динамическую цену за тысячу показов для сети медиации, системе автоматического сбора данных требуется несколько дней. Когда eCPM можно будет рассчитать, она будет автоматически обновлена.

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

Примечание. Если не интегрировать совместимые версии i-mobile и Google Mobile Ads SDK, могут возникнуть проблемы со сборкой.

Как использовать Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 2.3.4.2.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

2. В появившемся окне найдите следующий URL пакета:

   https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git
   

3. В разделе Правило зависимостей выберите Ветвь.

4. В текстовом поле введите main.

Через CocoaPods

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

  pod 'GoogleMobileAdsMediationIMobile'
  

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

  pod install --repo-update

Настраиваемые вручную интеграции

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

Шаг 4. Добавьте обязательный код

Как реализовать SKAdNetwork

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

Шаг 5. Протестируйте реализацию

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

Зарегистрируйте тестовое устройство в Менеджере рекламы. i-mobile предоставляет тестовые идентификаторы места, медиа и издателя. Их можно найти здесь.

Важно! Перед выпуском приложения отключите тестовый режим для Менеджера рекламы и i-mobile.

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

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

Необязательные действия

Использование нативных объявлений

Отображение объявлений

Адаптер i-mobile заполняет следующие поля для GADNativeAd.

Поле	Объекты, которые всегда включаются адаптером i-mobile
Заголовок
Изображение
Body
Значок приложения	^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 не поддерживает запросы нескольких межстраничных объявлений с одним и тем же идентификатором места.
107	Фильтруйте запросы с возрастными ограничениями для i-mobile SDK, поскольку он не может получать сигналы с возрастными ограничениями.

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

Версия 2.3.4.8

• Минимальная версия iOS была обновлена, чтобы ослабить зависимость Google Mobile Ads SDK и разрешить промежуточные версии.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.7.0.
• i-mobile SDK версии 2.3.4.

Версия 2.3.4.7

• Фильтрация запросов с возрастными ограничениями для i-mobile SDK, когда для параметра ageRestrictedTreatment задано значение GADAgeRestrictedTreatmentChild.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.4.0.
• i-mobile SDK версии 2.3.4.

Версия 2.3.4.6

• Фильтруйте запросы с возрастными ограничениями для i-mobile SDK, поскольку он не может получать сигналы с возрастными ограничениями.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.2.0.
• i-mobile SDK версии 2.3.4.

Версия 2.3.4.5

• Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.0.0.
• i-mobile SDK версии 2.3.4.

Версия 2.3.4.4

• Минимальная версия iOS для CocoaPods изменена на 13.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.0.0.
• i-mobile SDK версии 2.3.4.

Версия 2.3.4.3

• Исправлены названия фреймворка и зонтичного заголовка в файле IMobileAdapter modulemap.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 12.12.0.
• i-mobile SDK версии 2.3.4.

Версия 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.
• Добавлена поддержка возврата версии 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 или более поздней.
• В фреймворки IMobileAdapter.xcframework добавлен Info.plist.

Создано и протестировано с использованием:

• 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.
• Теперь при нажатии на нативное объявление адаптер пересылает обратный вызов -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 или более поздней.
• Добавлена поддержка масштабирования объявлений размером 320 x 50 и 320 x 100, чтобы они лучше соответствовали размерам запросов адаптивных баннеров.
• Прекращена поддержка архитектуры 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.