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

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

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

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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

Запишите идентификатор издателя, идентификатор медиаконтента и идентификатор места размещения. Эти параметры понадобятся вам позже при настройке i-mobile для медиации в интерфейсе Менеджера рекламы.

Как обновить файл 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 в интерфейсе Менеджера рекламы

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

Войдите в аккаунт Менеджера рекламы.

Откройте раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности.

Укажите уникальное название группы доходности, задайте Статус Активный, выберите Формат объявлений и задайте Тип инвентаря Мобильное приложение. В разделе Таргетинг > Инвентарь выберите рекламный блок в разделе Инвентарь и Мобильное приложение, в который вы хотите добавить медиацию.

Затем нажмите кнопку Добавить партнера по группе доходности.

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

Выберите i-mobile в качестве рекламной сети, введите уникальное название и включите медиацию.

Включите Автоматический сбор данных и введите имя пользователя и пароль API.

После того как вы выберете партнера по доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, Android в качестве платформы и Активно в качестве статуса. Введите идентификатор издателя, идентификатор медиаконтента и идентификатор рекламного места, полученные в предыдущем разделе. Затем введите стандартную цену за тысячу показов.

Нажмите Сохранить внизу страницы.

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

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

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