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

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

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

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

Android iOS Unity Flutter

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

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

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

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

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

Требования

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

Новейший SDK для мобильной рекламы Google
Заполните руководство по началу медиации.

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

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

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

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

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

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

create_ad_spot

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

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

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

список рекламных мест

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

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

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

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

Шаг 2: Настройте запрос i-mobile в пользовательском интерфейсе Ad Manager.

Настройте параметры медиации для вашего рекламного блока.

Войдите в свой аккаунт в Ad Manager .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» .

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

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

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

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

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

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

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

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

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

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

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

Затем в файле build.gradle.kts на уровне приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии SDK и адаптера i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.9.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: Протестируйте свою реализацию.

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

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

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

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

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

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

Отображение рекламы

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

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

^1. Для нативной рекламы SDK i-mobile не предоставляет значок приложения. Вместо этого адаптер 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, настроенные в пользовательском интерфейсе Ad Manager, отсутствуют/недействительны.
103	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому iMobile.
104	Функция обратного вызова при успешной загрузке нативной рекламы в i-mobile вернула пустой список нативных объявлений.