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

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

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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads Unity Plugin.
  • Unity Editor 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

    Запишите パブリッシャーID (идентификатор издателя), メディアID (идентификатор мультимедийного объекта) и スポットID (идентификатор места). Эти параметры понадобятся вам позже при настройке 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. Импортируйте SDK и адаптер i-mobile

    OpenUPM-CLI

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

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

    OpenUPM

    В редакторе проекта Unity выберите Edit (Изменить) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager Settings (Настройки менеджера пакетов 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 и нажмите Install (Установить).

    Установка из 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

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

    Шаг 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 i-mobile SDK вернул ошибку. Подробнее о коде…
    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