В этом руководстве показано, как использовать SDK Google Mobile Ads для загрузки и отображения рекламы с i-mobile с помощью медиации , включая интеграцию по принципу водопада. В нем рассматривается, как добавить i-mobile в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер i-mobile в приложение Flutter.
В интерфейсе панели управления i-mobile для надписей, кнопок и описаний используется японский текст. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства надписи и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер посредничества Ad Manager для i-mobile обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Родной | |
Требования
- Новейший SDK для мобильной рекламы Google
- Flutter 3.7.0 или выше
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Целевая версия iOS для развертывания — 12.0 или выше.
- Рабочий проект Flutter, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Заполните руководство по началу медиации.
Шаг 1: Настройка параметров в пользовательском интерфейсе i-mobile.
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Android
iOS
Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .
Android
iOS
Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Android
iOS
Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе Менеджера рекламы.
Android
iOS
Обновите файл app-ads.txt.
Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .
Чтобы внедрить app-ads.txt в i-mobile, ознакомьтесь с разделом часто задаваемых вопросов .
Шаг 2: Настройте запрос i-mobile в пользовательском интерфейсе Ad Manager.
Настройте параметры медиации для вашего рекламного блока.
Android
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Шаг 3: Импортируйте SDK и адаптер i-mobile.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями i-mobile SDK и адаптера в файл pubspec.yaml вашего пакета:
dependencies:
gma_mediation_imobile: ^1.0.2
Ручная интеграция
Загрузите последнюю версию плагина Google Mobile Ads Mediation для i-mobile , распакуйте загруженный файл и добавьте распакованную папку плагина (и ее содержимое) в свой проект Flutter. Затем добавьте ссылку на плагин в файл pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_imobile:
path: path/to/local/package
Шаг 4: Требуется дополнительный код
Android
Интеграция с iMobile не требует дополнительного кода.
iOS
Интеграция SKAdNetwork
Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации i-mobile .
Шаг 5: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в Ad Manager. i-mobile предоставляет тестовые идентификаторы Spot ID , Media ID и Publisher ID для тестирования, вы можете найти их здесь .
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений i-mobile (Waterfall) .
коды ошибок
Если адаптер не получает рекламу от 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, настроенные в пользовательском интерфейсе Ad Manager, отсутствуют или недействительны. |
| 103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. |
| 104 | Функция обратного вызова при успешной загрузке нативной рекламы в i-mobile вернула пустой список нативных объявлений. |
iOS
| Код ошибки | Причина |
|---|---|
| 0-10 | SDK i-mobile вернул ошибку. Подробности см. в коде . |
| 101 | Параметры сервера i-mobile, настроенные в пользовательском интерфейсе Ad Manager, отсутствуют или недействительны. |
| 102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile. |
| 103 | i-mobile не удалось показать рекламу. |
| 104 | i-mobile вернул пустой массив нативных рекламных объявлений. |
| 105 | i-mobile не удалось загрузить рекламные материалы. |
| 106 | i-mobile не поддерживает запрос на показ нескольких межстраничных объявлений с использованием одного и того же идентификатора Spot ID. |
Список изменений адаптера Flutter Mediation для i-mobile
Версия 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.