В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы с i-mobile с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока, а также как интегрировать i-mobile SDK и адаптер в приложение Flutter.
Интерфейс приборной панели i-Mobile использует японский текст для надписей, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки переведены, а их эквиваленты на английском языке указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер-медиатор Ad Manager для i-Mobile обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Родной | |
Требования
- Последняя версия Google Mobile Ads SDK
 - Flutter 3.7.0 или выше
 -  Для развертывания на Android
- Android API уровня 23 или выше
 
 -  Для развертывания на iOS
- Цель развертывания iOS 12.0 или выше
 
 - Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
 - Завершить посредничество . Руководство по началу работы.
 
Шаг 1: Настройте конфигурации в пользовательском интерфейсе i-mobile
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト/アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Андроид

iOS

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

iOS

Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Андроид

iOS

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

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

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

Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе Менеджера рекламы.
Андроид

iOS

Обновите файл app-ads.txt
 Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь в приложении будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt . Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы .
 Чтобы реализовать app-ads.txt для i-mobile, ознакомьтесь с разделом «Часто задаваемые вопросы» .
Шаг 2: Настройте спрос на i-mobile в пользовательском интерфейсе Менеджера рекламы
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3: Импортируйте i-mobile SDK и адаптер
Интеграция через pub.dev
 Добавьте следующую зависимость с последними версиями i-mobile SDK и адаптера в файл pubspec.yaml вашего пакета:
dependencies:
  gma_mediation_imobile: ^
Ручная интеграция
 Загрузите последнюю версию плагина-медиатора Google Mobile Ads для i-mobile , извлеките скачанный файл и добавьте извлеченную папку плагина (и её содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
  gma_mediation_imobile:
    path: path/to/local/package
Шаг 4: требуется дополнительный код
Андроид
Для интеграции с iMobile не требуется дополнительный код.
iOS
Интеграция SKAdNetwork
 Следуйте документации i-mobile , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Менеджере рекламы. i-mobile предоставляет тестовые идентификаторы Spot ID , Media ID и Publisher ID для тестирования, вы можете найти их здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений i-mobile (Waterfall ).
Коды ошибок
 Если адаптеру не удается получить рекламу от i-mobile, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo в следующих классах: 
Андроид
| Формат | Имя класса | 
|---|---|
| Баннер | com.google.ads.mediation.imobile.IMobileAdapter | 
| Интерстициальный | com.google.ads.mediation.imobile.IMobileAdapter | 
| Родной | com.google.ads.mediation.imobile.IMobileMediationAdapter | 
iOS
| Формат | Имя класса | 
|---|---|
| Баннер | iMobileAdapter | 
| Интерстициальный | iMobileAdapter | 
| Родной | GADMediationAdapterIMobile | 
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-Mobile, когда реклама не загружается:
Андроид
| Код ошибки | Причина | 
|---|---|
| 0-99 | i-mobile SDK вернул ошибку. Подробнее см. в коде . | 
| 101 |  i-mobile требует контекст Activity для загрузки рекламы. | 
| 102 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны. | 
| 103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. | 
| 104 | Обратный вызов i-mobile об успешной загрузке собственной рекламы вернул пустой список собственных объявлений. | 
iOS
| Код ошибки | Причина | 
|---|---|
| 0-10 | i-mobile SDK вернул ошибку. Подробнее см. в коде . | 
| 101 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны. | 
| 102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. | 
| 103 | i-mobile не смог показать рекламу. | 
| 104 | i-mobile вернул пустой массив собственных объявлений. | 
| 105 | i-mobile не удалось загрузить собственные рекламные ресурсы. | 
| 106 | i-mobile не поддерживает запрос нескольких полноэкранных объявлений с использованием одного и того же идентификатора Spot ID. | 
Журнал изменений адаптера Flutter Mediation для i-mobile
Версия 1.0.1
- Поддерживает Android-адаптер i-mobile версии 2.3.2.1 .
 - Поддерживает адаптер iOS i-mobile версии 2.3.4.2 .
 - Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 6.0.0.
 
Версия 1.0.0
- Первоначальный выпуск.
 - Поддерживает Android-адаптер i-mobile версии 2.3.2.0 .
 - Поддерживает адаптер iOS i-mobile версии 2.3.4.1 .
 - Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 5.3.1.