В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы с i-mobile с помощью посредничество ,охватывающая водопадную интеграцию. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока, а также как интегрировать i-mobile SDK и адаптер в Android приложение.
Интерфейс информационной панели i-mobile использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для i-mobile имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Родной |
Требования
- Android API уровня 21 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе i-mobile.
Зарегистрируйтесь или войдите в свою учетную запись i-mobile.
Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト/アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.
Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .
Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .
Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .
Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .
Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .
Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе Менеджера рекламы.
Шаг 2. Настройте спрос на i-mobile в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Войдите в свою учетную запись Менеджера рекламы .
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» .
Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.
Затем нажмите кнопку «Добавить партнера по доходности» .
Если у вас уже есть партнер по доходности для i-mobile, вы можете выбрать его. В противном случае выберите Создать нового партнера по доходности .
Выберите i-mobile в качестве рекламной сети , введите уникальное имя и включите посредничество .
Включите автоматический сбор данных и введите имя для входа и пароль API.
После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . Введите идентификатор издателя , идентификатор носителя и идентификатор Spot, полученные в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .
Когда закончите, нажмите «Сохранить» внизу страницы.
Шаг 3. Импортируйте SDK и адаптер i-mobile.
Интеграция с Android Studio (рекомендуется)
В файле settings.gradle.kts
уровня проекта добавьте следующие репозитории:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile.github.io/adnw-sdk-android")
}
}
}
Затем в файл build.gradle.kts
уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии i-mobile SDK и адаптера:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Ручная интеграция
Загрузите последнюю версию i-mobile SDK , извлеките файл
android-ad-sdk.aar
из папкиsdk
и добавьте его в свой проект.Перейдите к артефактам адаптера i-mobile в репозитории Google Maven. Выберите последнюю версию, загрузите файл
.aar
адаптера i-mobile и добавьте его в свой проект.
Шаг 4. Добавьте необходимый код
Для интеграции i-mobile не требуется никакого дополнительного кода.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы. i-mobile предоставляет для тестирования идентификатор тестовой точки , идентификатор носителя и идентификатор издателя , их можно найти здесь .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений i-mobile (Waterfall) .
Дополнительные шаги
Использование нативной рекламы
Рендеринг рекламы
Адаптер i-mobile заполняет следующееполядляNativeAd
.
Поле | Ресурсы, всегда включенные в адаптер i-mobile |
---|---|
Заголовок | |
Изображение | |
Тело | |
Значок приложения | 1 |
Призыв к действию | |
Звездный рейтинг | |
Магазин | |
Цена |
1 Для нативной рекламы i-mobile SDK не предоставляет значок приложения. Вместо этого адаптер i-mobile заполняет значок приложения прозрачным изображением.
Коды ошибок
Если адаптеру не удается получить рекламу от i-mobile, издатели могут проверить основную ошибку из ответа на объявление, используяResponseInfo.getAdapterResponses()
по следующим классам:
Формат | Имя класса |
---|---|
Баннер | com.google.ads.mediation.imobile.IMobileAdapter |
Межстраничный | com.google.ads.mediation.imobile.IMobileAdapter |
Родной | com.google.ads.mediation.imobile.IMobileMediationAdapter |
Вот коды и сопутствующие сообщения, выдаваемые адаптером i-mobile, когда реклама не загружается:
Код ошибки | Причина |
---|---|
0-99 | i-mobile SDK вернул ошибку. См. код для более подробной информации. |
101 | i-mobile требует контекста Activity для загрузки рекламы. |
102 | параметры сервера i-mobile, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен. |
103 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile. |
104 | Обратный вызов об успешной загрузке встроенной рекламы i-mobile вернул пустой список встроенной рекламы. |
Журнал изменений адаптера медиации i-mobile Android
Версия 2.3.2.0
- Проверенная совместимость с i-mobile SDK v2.3.2.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.1.0.
- IMobile SDK версии 2.3.2.
Версия 2.3.1.2
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 23.0.0.
- Проверенная совместимость с i-mobile SDK v2.3.1.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- IMobile SDK версии 2.3.1.
Версия 2.3.1.1
- Обновлен адаптер для использования нового класса
VersionInfo
. - Минимальная необходимая версия Google Mobile Ads SDK обновлена до 22.0.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.0.0.
- IMobile SDK версии 2.3.1.
Версия 2.3.1.0
- Проверенная совместимость с i-mobile SDK v2.3.1.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 21.5.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.5.0.
- IMobile SDK версии 2.3.1.
Версия 2.3.0.0
- Проверенная совместимость с i-mobile SDK v2.3.0.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 21.3.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.3.0.
- IMobile SDK версии 2.3.0.
Версия 2.0.23.1
-
compileSdkVersion
иtargetSdkVersion
обновлены до API 31. - Минимальная необходимая версия Google Mobile Ads SDK обновлена до 21.0.0.
- Минимально необходимый уровень Android API обновлен до 19.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.0.0.
- IMobile SDK версии 2.0.23.
Версия 2.0.23.0
- Проверенная совместимость с i-mobile SDK v2.0.23.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 20.5.0.
Создан и протестирован с
- Google Mobile Ads SDK версии 20.5.0.
- IMobile SDK версии 2.0.23.
Версия 2.0.22.2
- Добавлены стандартизированные коды ошибок и сообщения адаптера.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 20.1.0.
Создан и протестирован с
- Google Mobile Ads SDK версии 20.1.0.
- Imobile SDK версии 2.0.22.
Версия 2.0.22.1
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 20.0.0.
Создан и протестирован с
- Google Mobile Ads SDK версии 20.0.0.
- Imobile SDK версии 2.0.22.
Версия 2.0.22.0
- Проверенная совместимость с i-mobile SDK v2.0.22.
- Обновлен адаптер для поддержки запросов встроенных адаптивных баннеров.
Создан и протестирован с
- Google Mobile Ads SDK версии 19.1.0.
- Imobile SDK версии 2.0.22.
Версия 2.0.21.0
- Проверенная совместимость с i-mobile SDK v2.0.21.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 19.1.0.
- Добавлена поддержка масштабирования адаптивных баннеров.
Создан и протестирован с
- Google Mobile Ads SDK версии 19.1.0.
- Imobile SDK версии 2.0.21.
Версия 2.0.20.2
- Добавлена поддержка гибких размеров баннерной рекламы.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 18.3.0.
Создан и протестирован с
- Google Mobile Ads SDK версии 18.3.0.
- Imobile SDK версии 2.0.20.
Версия 2.0.20.1
- Адаптер теперь возвращает ненулевое соотношение сторон
mediaContent
.
Создан и протестирован с
- Google Mobile Ads SDK версии 18.2.0.
- Imobile SDK версии 2.0.20.
Версия 2.0.20.0
- Первый выпуск!
- Добавлена поддержка баннерной, межстраничной и нативной рекламы.