В этом руководстве показано, как использовать 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.