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

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

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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads Unity Plugin.
  • Редактор Unity версии 5.6 или более поздней.
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая версия iOS – 13.0 или более поздняя.
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads Unity Plugin. Подробная информация приведена в статье Как настроить Google Mobile Ads Unity Plugin.
  • Настройте медиацию.

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

Как обновить файл 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 в интерфейсе Менеджера рекламы

Как настроить медиацию для рекламного блока

Android

Инструкции приведены в разделе "Шаг 2" Android.

iOS

Инструкции приведены в разделе "Шаг 2" руководства для iOS.

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

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI, вы можете добавить в проект плагин медиации Google Mobile Ads i-mobile для Unity, выполнив следующую команду в корневом каталоге проекта:

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

В редакторе проекта Unity выберите Edit (Правка) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов), чтобы открыть настройки менеджера пакетов Unity.

На вкладке Scoped Registries (Реестры с областью действия) добавьте OpenUPM в качестве реестра с областью действия, указав следующие сведения:

  • Название: OpenUPM
  • URL: https://package.openupm.com
  • Области действия: com.google

Подробности OpenUPM

Затем выберите Window (Окно) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager (Менеджер пакетов Unity), и в раскрывающемся меню выберите My Registries (Мои реестры).

Реестры Unity

Выберите пакет Google Mobile Ads IMobile Mediation и нажмите Установить.

Установка из OpenUPM

Пакет Unity

Скачайте последнюю версию плагина медиации Google Mobile Ads для i-mobile по ссылке в журнале изменений и извлеките файл GoogleMobileAdsIMobileMediation.unitypackage из ZIP-архива.

В редакторе проекта Unity выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Специальный пакет) и найдите скачанный файл GoogleMobileAdsIMobileMediation.unitypackage. Убедитесь, что выбраны все файлы, и нажмите Импортировать.

Импорт из Unity

Затем выберите Assets (Ресурсы) > External Dependency Manager (Менеджер внешних зависимостей) > Android Resolver (Решатель Android) > Force Resolve (Принудительное разрешение). Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android приложения Unity.

Принудительное разрешение

Шаг 4. Требуется дополнительный код

Android

Для интеграции с i-mobile не требуется дополнительный код.

iOS

Интеграция с SKAdNetwork

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

Шаг 5. Проверьте реализацию

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

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

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

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

Коды ошибок

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

Android

Формат Название класса
Баннер com.google.ads.mediation.imobile.IMobileAdapter
Межстраничное объявление com.google.ads.mediation.imobile.IMobileAdapter
Стандартное com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

Формат Название класса
Баннер IMobileAdapter
Межстраничное объявление IMobileAdapter
Стандартное GADMediationAdapterIMobile

Ниже приведены коды и сообщения, которые адаптер i-mobile возвращает, когда не удается загрузить объявление:

Android

Код ошибки Причина
0-99 SDK i-mobile вернул ошибку. Подробнее о коде…
101 Для загрузки объявлений i-mobile требуется контекст Activity.
102 Параметры сервера i-mobile, настроенные в интерфейсе Менеджера рекламы, отсутствуют или недействительны.
103 Запрошенный размер объявления не соответствует поддерживаемому i-mobile размеру баннера.
104 Обратный вызов успешной загрузки нативного объявления i-mobile вернул пустой список нативных объявлений.

iOS

Код ошибки Причина
0-10 SDK i-mobile вернул ошибку. Подробнее о коде…
101 Параметры сервера i-mobile, настроенные в интерфейсе Менеджера рекламы, отсутствуют или недействительны.
102 Запрошенный размер объявления не соответствует поддерживаемому i-mobile размеру баннера.
103 Не удалось показать объявление i-mobile.
104 i-mobile вернул пустой массив нативных объявлений.
105 i-mobile не удалось скачать объекты нативного объявления.
106 i-mobile не поддерживает запросы на несколько объявлений-заставок с одним и тем же идентификатором места размещения.

История изменений плагина i-mobile Mediation для Unity

Версия 1.3.16

Версия 1.3.15

Версия 1.3.14

Версия 1.3.13

Версия 1.3.12

Версия 1.3.11

Версия 1.3.10

Версия 1.3.9

Версия 1.3.8

Версия 1.3.7

Версия 1.3.6

Версия 1.3.5

Версия 1.3.4

Версия 1.3.3

Версия 1.3.2

Версия 1.3.1

Версия 1.3.0

Версия 1.2.2

Версия 1.2.1

Версия 1.2.0

Версия 1.1.0

Версия 1.0.2

Версия 1.0.1

Версия 1.0.0