Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать i-mobile с медиацией

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

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

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

Android API уровня 24 или более поздней версии.

Последняя версия Google Mobile Ads SDK (Legacy).
Настройте медиацию AdMob.

Шаг 1. Задайте настройки в интерфейсе i-mobile

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

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

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

Чтобы создать рекламное место, выберите приложение на вкладке サイト／アプリ管理 (Управление сайтами и приложениями).

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Обновите файл app-ads.txt

Решение Authorized Sellers for Apps (app-ads.txt), разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, настройте файл app-ads.txt для приложения.

Чтобы реализовать app-ads.txt для i-mobile, ознакомьтесь с часто задаваемыми вопросами.

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

Как настроить медиацию для рекламного блока

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

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

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

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

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

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

Выбранные рекламные блоки появятся на карточке:

Как добавить i-mobile в качестве источника объявлений

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

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

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

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

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

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

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

В файле gradle на уровне приложения добавьте следующие зависимости реализации:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

Интеграция вручную

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

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

Загрузка объявления с контекстом действия

При загрузке баннеров, межстраничных объявлений, объявлений с вознаграждением и нативных объявлений передавайте контекст Activity. Без него загрузка объявлений не будет выполняться.

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

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

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

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

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

Необязательные действия

Использование нативных объявлений

Отображение объявлений

Адаптер i-mobile заполняет следующие описания полей расширенных нативных объявлений для NativeAd.

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

¹ В 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 вернул пустой список нативных объявлений.
105	Запрос обработан с учетом возрастных ограничений, но i-mobile SDK не может получать сигналы о возрастных ограничениях.

Журнал изменений адаптера i-mobile для медиации Android