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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Шаг 2. Настройте спрос на i-mobile в AdMob пользовательский интерфейс

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

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

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

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

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

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

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

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

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


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

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



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

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

Шаг 3. Импортируйте SDK и адаптер i-mobile.

В файле 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")
}

Ручная интеграция

  1. Загрузите последнюю версию i-mobile SDK , извлеките файл android-ad-sdk.aar из папки sdk и добавьте его в свой проект.

  2. Перейдите к артефактам адаптера i-mobile в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера i-mobile и добавьте его в свой проект.

Шаг 4. Добавьте необходимый код

Для интеграции i-mobile не требуется никакого дополнительного кода.

Шаг 5. Проверьте свою реализацию

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

Обязательно зарегистрируйте тестовое устройство в AdMob. 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, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен.
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

  • Первый выпуск!
  • Добавлена ​​поддержка баннерной, межстраничной и нативной рекламы.
,

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

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

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

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

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

Требования

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

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Шаг 2. Настройте спрос на i-mobile в AdMob пользовательский интерфейс

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

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

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

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

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

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

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

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

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


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

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



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

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

Шаг 3. Импортируйте SDK и адаптер i-mobile.

В файле 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")
}

Ручная интеграция

  1. Загрузите последнюю версию i-mobile SDK , извлеките файл android-ad-sdk.aar из папки sdk и добавьте его в свой проект.

  2. Перейдите к артефактам адаптера i-mobile в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера i-mobile и добавьте его в свой проект.

Шаг 4. Добавьте необходимый код

Для интеграции i-mobile не требуется никакого дополнительного кода.

Шаг 5. Проверьте свою реализацию

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

Обязательно зарегистрируйте тестовое устройство в AdMob. 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, настроенные в AdMob Пользовательский интерфейс отсутствует/недействителен.
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

  • Первый выпуск!
  • Добавлена ​​поддержка баннерной, межстраничной и нативной рекламы.