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

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

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

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

Адаптер медиации AdMob для 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.
  • Настройте медиацию AdMob.

Шаг 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 для медиации в интерфейсе AdMob.

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 в интерфейсе AdMob

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

Android

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

iOS

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

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

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

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

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

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

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. Проверьте реализацию

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

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

iOS

Код ошибки Причина
0-10 SDK i-mobile вернул ошибку. Подробнее о коде…
101 Параметры сервера i-mobile, настроенные в интерфейсе AdMob, отсутствуют или являются недействительными.
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