В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы с i-mobile с помощью медиации , включая каскадную интеграцию. В нём также рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока, а также как интегрировать i-mobile SDK и адаптер в приложение Flutter.
Интерфейс приборной панели i-Mobile использует японский текст для надписей, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства надписи и кнопки переведены, а их эквиваленты на английском языке указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер-медиатор AdMob для 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 для медиации в интерфейсе AdMob.
Андроид
iOS
Обновите файл app-ads.txt
Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt
. Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .
Чтобы реализовать app-ads.txt
для i-mobile, ознакомьтесь с разделом «Часто задаваемые вопросы» .
Шаг 2: Настройте спрос на мобильные устройства в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 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: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob. 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, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны. |
103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. |
104 | Обратный вызов i-mobile об успешной загрузке собственной рекламы вернул пустой список собственных объявлений. |
iOS
Код ошибки | Причина |
---|---|
0-10 | i-mobile SDK вернул ошибку. Подробнее см. в коде . |
101 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны. |
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.