Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

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

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

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

Поддерживаемые интеграции и форматы рекламы

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

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

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

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

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

создать_рекламное_место

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

новая_рекламная_форма

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

ad_spot_list

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

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

Файл 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.

После выбора партнера по Yield выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Active в качестве статуса . Введите идентификатор издателя , идентификатор медиа и идентификатор точки, полученные в предыдущем разделе. Затем введите значение CPM по умолчанию .

По завершении нажмите кнопку «Сохранить» внизу страницы.

Шаг 3: Импортируйте i-mobile 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:24.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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