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

В этом руководстве показано, как использовать 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, щелкнув вкладку «サイト／アプリ管理» (Управление сайтом/приложением) и кнопку, соответствующую платформе вашего приложения.

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

Примечание. 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.

Примечание. Невозможность интеграции совместимых версий i-mobile и Google Mobile Ads SDK может привести к проблемам при сборке.

Интеграция с 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")
}

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

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

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

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

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

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

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

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

Важно! Перед выпуском приложения отключите тестовый режим для Менеджера рекламы и i-mobile.

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

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

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

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

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

Адаптер i-mobile заполняет следующееполядляNativeAd .

Поле	Ресурсы, всегда включенные в адаптер i-mobile
Заголовок
Изображение
Тело
Значок приложения	^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

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