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

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

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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads Flutter Plugin.
  • Фреймворк Flutter 3.7.0 или более поздней версии.
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на iOS:
    • Целевая версия iOS для развертывания – 13.0 или более поздняя.
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads Flutter Plugin. Подробные сведения приведены в статье Как настроить Google Mobile Ads Flutter 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. Импортируйте SDK и адаптер i-mobile

    Интеграция через pub.dev

    (Только для Android) Добавьте следующие репозитории в файл build.gradle в каталоге android проекта:

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile.github.io/adnw-sdk-android")
      }
  }

    Добавьте в файл pubspec.yaml пакета следующую зависимость с последними версиями SDK и адаптера i-mobile:

    dependencies:
  gma_mediation_imobile: ^1.0.6

    Интеграция вручную

    Скачайте последнюю версию плагина медиации Google Mobile Ads для i-mobile, распакуйте скачанный файл и добавьте распакованную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

    dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

    Шаг 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 i-mobile SDK вернул ошибку. Подробную информацию можно найти в коде.
    101 Для загрузки объявлений i-mobile требуется контекст Activity.
    102 Параметры сервера i-mobile, настроенные в интерфейсе Менеджера рекламы, отсутствуют или недействительны.
    103 Запрошенный размер объявления не соответствует поддерживаемому i-mobile размеру баннера.
    104 Обратный вызов успешной загрузки объявлений нативного формата i-mobile вернул пустой список нативных объявлений.

    iOS

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

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

    Версия 1.0.6

    Версия 1.0.5

    Версия 1.0.4

    Версия 1.0.3

    Версия 1.0.2

    Версия 1.0.1

    Версия 1.0.0