В этом руководстве рассказывается, как 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

Перейдите на вкладку 広告スポット管理 (Управление рекламными местами) и нажмите кнопку 新規広告スポット (Новое рекламное место).
Затем заполните форму, указав 広告スポット名 (Название рекламного места), 広告スポットサイズ (Размер рекламного места) и другие сведения. Затем нажмите кнопку 新規登録 (Зарегистрироваться).
Ваша новая рекламная вставка готова. Чтобы посмотреть сведения об интеграции, нажмите кнопку アプリ設定取得 (Получить настройки приложения).
Запишите идентификатор издателя, идентификатор медиаконтента и идентификатор места размещения. Эти параметры понадобятся вам позже при настройке 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
- Поддерживает адаптер i-mobile для Android версии 2.3.2.5.
- Поддержка адаптера i-mobile для iOS версии 2.3.4.8.
- Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 9.1.0.
Версия 1.0.5
- Добавлена поддержка плагина Google Mobile Ads для Flutter версии 9.1.0.
- Добавлена поддержка Swift Package Manager.
- Поддерживается адаптер i-mobile для Android версии 2.3.2.4.
- Поддержка адаптера i-mobile для iOS версии 2.3.4.8.
- Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 9.1.0.
Версия 1.0.4
- Поддерживает адаптер i-mobile для Android версии 2.3.2.3.
- Поддерживает адаптер i-mobile для iOS версии 2.3.4.7.
- Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 8.0.0.
Версия 1.0.3
- Минимальная версия Flutter обновлена до 3.38.1
- Добавлена поддержка плагина Google Mobile Ads для Flutter версии 8.0.0
- Поддерживает адаптер i-mobile для Android версии 2.3.2.3.
- Поддержка адаптера i-mobile для iOS версии 2.3.4.6.
- Создано и протестировано с помощью Google Mobile Ads Flutter Plugin версии 8.0.0.
Версия 1.0.2
- Поддерживает адаптер i-mobile для Android версии 2.3.2.1.
- Поддержка адаптера i-mobile для iOS версии 2.3.4.3.
- Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 6.0.0.
Версия 1.0.1
- Поддерживает адаптер i-mobile для Android версии 2.3.2.1.
- Поддержка адаптера i-mobile для iOS версии 2.3.4.2.
- Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 6.0.0.
Версия 1.0.0
- Первый выпуск.
- Поддерживает адаптер i-mobile для Android версии 2.3.2.0.
- Поддержка адаптера i-mobile для iOS версии 2.3.4.1.
- Создано и протестировано с помощью плагина Google Mobile Ads для Flutter версии 5.3.1.