Эта страница переведена с помощью Cloud Translation API.

Интегрируйте i-mobile с медиацией

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы с i-mobile с помощью AdMob Mediation , а также рассматривается каскадная интеграция. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер i-mobile в приложение Android.

Интерфейс информационной панели i-mobile использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.

Поддерживаемые интеграции и форматы объявлений

Адаптер-посредник для i-mobile имеет следующие возможности:

Интеграция
Торги
Водопад
Форматы
Баннер
Межстраничный
Награжден
Родной

Требования

Android API уровня 21 или выше

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

Шаг 1. Настройте конфигурации в пользовательском интерфейсе i-mobile.

Зарегистрируйтесь или войдите в свою учетную запись i-mobile.

Добавьте свое приложение на панель управления i-mobile, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.

Заполните форму и нажмите кнопку新規登録 (Зарегистрироваться) .

Чтобы создать новое рекламное место, выберите свое приложение на вкладке «Управление сайтом/приложением» .

Перейдите на вкладку広告スポット管理 (Управление рекламными местами) и нажмите кнопку新規広告スポット (Новое рекламное место) .

create_ad_spot

Затем заполните форму, указав広告スポット名 (название рекламного места) ,広告スポットサイズ (размер рекламного места) и другие данные. Затем нажмите кнопку新規登録 (Зарегистрироваться) .

new_ad_spot_form

Ваше новое рекламное место готово. Чтобы просмотреть детали интеграции, нажмите кнопкуアプリ設定取得 (Получить настройки приложения) .

ad_spot_list

Обратите внимание наパブリッシャーID (идентификатор издателя) ,メディアID (идентификатор носителя) иスポットID (идентификатор рекламного ролика) . Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе AdMob.

Шаг 2. Настройте спрос на мобильные устройства в интерфейсе AdMob.

Настройте параметры медиации для своего рекламного блока

Вам необходимо добавить i-mobile в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Далее перейдите на вкладку «Медиация» . Если у вас есть существующая группа медиации, которую вы хотите изменить, нажмите на название этой группы медиации, чтобы изменить ее, и перейдите к пункту «Добавить i-mobile в качестве источника объявлений» .

Чтобы создать новую группу медиации, выберите Создать группу медиации .

Введите формат объявления и платформу, затем нажмите «Продолжить» .

Дайте группе медиации название и выберите целевые местоположения. Затем установите статус группы медиации на «Включено » и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте i-mobile в качестве источника рекламы

Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите i-mobile .

Выберите i-mobile и включите переключатель «Оптимизировать» . Введите имя для входа и пароль API, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для i-mobile. Затем введите значение эффективной цены за тысячу показов для i-mobile и нажмите «Продолжить» .

Если у вас уже есть карта для i-mobile, вы можете выбрать ее. В противном случае нажмите «Добавить сопоставление» .

Затем введите идентификатор издателя , идентификатор носителя и идентификатор Spot, полученные в предыдущем разделе. Затем нажмите Готово .

Примечание . Оптимизация источника объявлений требует нескольких дней, чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов для сети медиации. В то же время статус оптимизации источника объявлений — PENDING , поэтому вам необходимо вручную установить значение эффективной цены за тысячу показов для сети. Как только эффективная цена за тысячу показов будет рассчитана, источник объявлений автоматически начнет обновлять ее от вашего имени.

Шаг 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. Проверьте свою реализацию

Включить тестовые объявления

Обязательно зарегистрируйте тестовое устройство в AdMob. i-mobile предоставляет для тестирования идентификатор тестовой точки , идентификатор носителя и идентификатор издателя . Их можно найти здесь .

Проверьте тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от i-mobile, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений i-mobile (Waterfall) .

Дополнительные шаги

Использование нативной рекламы

Рендеринг рекламы

Адаптер i-mobile заполняет следующие описания дополнительных полей Native Ads для NativeAd .

Поле	Ресурсы, всегда включенные в адаптер i-mobile
Заголовок
Изображение
Тело
Значок приложения	¹
Призыв к действию
Звездный рейтинг
Магазин
Цена

¹ Для нативной рекламы 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, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
103	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому i-mobile.
104	Обратный вызов при успешной загрузке встроенной рекламы i-mobile вернул пустой список встроенной рекламы.