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

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

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

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

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

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

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

Шаг 2: Настройте спрос на мобильные устройства в пользовательском интерфейсе AdMob

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

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

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

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

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавить i-mobile как источник рекламы

На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

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

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

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

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

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

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

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