Как интегрировать 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 версии 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. Импортируйте i-mobile SDK и адаптер

    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.

    На вкладке 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

    Добавьте идентификаторы 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 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