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

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

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

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как с помощью Google Mobile Ads SDK (Legacy) загружать и показывать объявления из i-mobile, используя медиацию AdMob, в том числе каскадную интеграцию. В нем рассказывается, как добавить i-mobile в конфигурацию медиации рекламного блока и как интегрировать i-mobile SDK и адаптер в приложение для 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

Запишите идентификатор издателя, идентификатор медиаконтента и идентификатор места размещения. Эти параметры понадобятся вам позже при настройке 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 и включите переключатель Оптимизировать. Введите имя пользователя и пароль API, полученные в предыдущем разделе, чтобы настроить оптимизацию источника объявлений для i-mobile. Затем введите эффективную цену за тысячу показов для i-mobile и нажмите Продолжить.

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

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

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

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

Интеграция с 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 в репозитории Google Maven. Выберите последнюю версию, скачайте файл .aar адаптера i-mobile и добавьте его в проект.

Шаг 4. Добавьте обязательный код

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

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

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

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

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

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

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

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

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

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

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

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

¹ Для нативных объявлений в 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	SDK i-mobile вернул ошибку. Подробнее о коде…
101	Для загрузки объявлений i-mobile требуется контекст `Activity`.
102	Параметры сервера i-mobile, настроенные в интерфейсе AdMob, отсутствуют или являются недействительными.
103	Запрошенный размер объявления не соответствует поддерживаемому i-mobile размеру баннера.
104	Обратный вызов успешной загрузки нативного объявления i-mobile вернул пустой список нативных объявлений.
105	В запросе была указана обработка с учетом возрастных ограничений, но i-mobile SDK не может получать сигналы, связанные с возрастными ограничениями.