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

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

Интегрируйте InMobi с медиацией

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

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

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

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

¹ Поддерживается только для каскадной модели посредничества.

Требования

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

[Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте адаптер InMobi 10.6.3.0 или выше ( рекомендуется последняя версия )

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

Шаг 1: Настройте конфигурации в InMobi UI

Зарегистрируйте учётную запись InMobi. При создании учётной записи не устанавливайте флажок «Использовать InMobi SSP с Google Open Bidding» .

После подтверждения вашей учетной записи войдите в систему .

Добавить приложение

Чтобы добавить свое приложение на панель управления InMobi, нажмите Инвентарь > Настройки инвентаря .

Нажмите «Добавить инвентарь» и выберите канал мобильного приложения из раскрывающегося меню.

Начните вводить URL-адрес опубликованного магазина приложений в строке поиска и выберите приложение из автоматически подставленных результатов. Нажмите «Продолжить» .

Если ваше приложение ещё не опубликовано, нажмите «Связать вручную» и введите необходимые данные. Нажмите «Продолжить» .

Проверьте настройки соответствия приложений и веб-сайтов , а затем нажмите «Сохранить и создать места размещения» .

Размещения

После настройки инвентаря система перенаправит вас к процессу создания места размещения.

Торги

Выберите тип рекламного блока. Введите название плейсмент-места , выберите «On» и «Google Open Bidding» для Audience Bidding и «Партнер» соответственно, а затем заполните оставшуюся часть формы. После завершения нажмите «Создать плейсмент-место» .

Водопад

Выберите тип рекламного блока. Затем введите название плейсмент-места , выберите «Отключить для ставок на аудиторию » и заполните оставшуюся часть формы. После завершения нажмите «Создать плейсмент-место» .

После создания места размещения отобразятся его данные. Запишите идентификатор места размещения, который будет использоваться для настройки вашего рекламного блока AdMob.

Идентификатор учетной записи

Идентификатор вашего аккаунта InMobi доступен в разделе «Финансы» > «Настройки платежей» > «Информация о платежах» .

Найдите ключ API для отчетов InMobi

Торги

Этот шаг не требуется для интеграции торгов.

Водопад

Перейдите в раздел «Моя учётная запись» > «Настройки учётной записи» . Перейдите на вкладку «Ключ API» и нажмите «Сгенерировать ключ API» .

Выберите адрес электронной почты пользователя, для которого требуется ключ, и нажмите «Сгенерировать ключ API» . Будет сгенерирован файл, содержащий ключ API и имя пользователя/логин.

Только администратор аккаунта издателя сможет сгенерировать ключ API для всех пользователей. Если вы забыли ранее сгенерированный ключ API, сбросьте его, наведя курсор на свой адрес электронной почты на вкладке «Ключ API» .

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

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

Чтобы реализовать app-ads.txt для InMobi, добавьте свой персонализированный фрагмент кода .

Включить тестовый режим

Включите тестовый режим для вашего места размещения на всех показах в реальном времени или только на определенных тестовых устройствах.

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

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

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

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

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

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

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

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

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

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

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите InMobi (SDK) .

Нажмите «Как подписать партнерское соглашение» и настроить партнерство с InMobi для участия в торгах .

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

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

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

Водопад

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

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

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

Добавьте InMobi в список рекламных партнеров, соответствующих GDPR и государственным нормам США

Следуйте инструкциям в настройках европейских и государственных нормативных актов США, чтобы добавить InMobi в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе AdMob.

Шаг 3: Импортируйте InMobi SDK и адаптер

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:inmobi:10.8.3.1")
}

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

Загрузите InMobi Android SDK , извлеките файл InMobiSDK.aar из папки libs и добавьте его в свой проект.
Перейдите к артефактам адаптера InMobi в репозитории Maven от Google. Выберите последнюю версию, скачайте .aar -файл адаптера InMobi и добавьте его в свой проект.
InMobi также требует подключения других зависимостей. Подробнее см. в документации InMobi .

Шаг 4: Реализуйте настройки конфиденциальности в InMobi SDK

Согласие ЕС и GDPR

В соответствии с Политикой Google в отношении согласия пользователей в ЕС вы обязаны обеспечить предоставление определённой информации и получение согласия от пользователей в Европейской экономической зоне (ЕЭЗ) в отношении использования идентификаторов устройств и персональных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента по защите данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредников, которая может собирать, получать или использовать персональные данные, а также предоставить информацию об использовании каждой сетью. В настоящее время Google не может автоматически передавать согласие пользователя таким сетям.

В версии 7.1.0.0 адаптер InMobi добавил класс InMobiConsent , позволяющий передавать информацию о согласии в InMobi. Следующий пример кода вызывает метод updateGDPRConsent() класса InMobiConsent . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

Ява

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  exception.printStackTrace();
}

InMobiConsent.updateGDPRConsent(consentObject);

Котлин

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  exception.printStackTrace()
}

InMobiConsent.updateGDPRConsent(consentObject)

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

Законы США о конфиденциальности

Законы США о конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как этот термин определен в законе). Отказ осуществляется через заметную ссылку «Не продавайте мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о конфиденциальности предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вам необходимо указать каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей для обеспечения соблюдения правил.

В версии 10.5.7.1 адаптер InMobi добавил поддержку чтения строки конфиденциальности IAB US Privacy из общих настроек. Следуйте инструкциям в документации по законам о конфиденциальности штатов США, чтобы настроить строку конфиденциальности US Privacy в общих настройках.

Кроме того, ознакомьтесь с документацией CCPA компании InMobi, где вы найдете инструкции по включению настроек CCPA на панели управления InMobi.

Шаг 5: требуется дополнительный код

Для интеграции InMobi дополнительный код не требуется.

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе InMobi.

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

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

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

Разрешения

Для оптимальной производительности InMobi рекомендует добавить следующие необязательные разрешения в файл AndroidManifest.xml вашего приложения.

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

Параметры, специфичные для сети

Адаптер InMobi поддерживает дополнительные параметры запроса, которые можно передать адаптеру в виде пакета Android Bundle. Адаптер ищет в пакете следующие ключи:

Параметры и значения запроса
`InMobiNetworkKeys.AGE_GROUP` Возрастная группа пользователя.	`InMobiNetworkValues.BELOW_18` `InMobiNetworkValues.BETWEEN_18_AND_24` `InMobiNetworkValues.BETWEEN_25_AND_29` `InMobiNetworkValues.BETWEEN_30_AND_34` `InMobiNetworkValues.BETWEEN_35_AND_44` `InMobiNetworkValues.BETWEEN_45_AND_54` `InMobiNetworkValues.BETWEEN_55_AND_65` `InMobiNetworkValues.ABOVE_65`
`InMobiNetworkKeys.EDUCATION` Уровень образования пользователя.	`InMobiNetworkValues.EDUCATION_HIGHSCHOOLORLESS` `InMobiNetworkValues.EDUCATION_COLLEGEORGRADUATE` `InMobiNetworkValues.EDUCATION_POSTGRADUATEORABOVE`
`InMobiNetworkKeys.AGE`	Строка . Возраст пользователя.
`InMobiNetworkKeys.POSTAL_CODE`	Строка . Почтовый индекс пользователя (обычно пятизначное число).
`InMobiNetworkKeys.AREA_CODE`	Строка . Код города пользователя (часть номера телефона).
`InMobiNetworkKeys.LANGUAGE`	Строка . Родной язык пользователя (если известен).
`InMobiNetworkKeys.CITY`	Строка . Город пользователя.
`InMobiNetworkKeys.STATE`	Строка . Состояние пользователя.
`InMobiNetworkKeys.COUNTRY`	Строка . Страна пользователя.
`InMobiNetworkKeys.LOGLEVEL` Устанавливает уровень журнала для InMobi SDK.	`InMobiNetworkValues.LOGLEVEL_NONE` `InMobiNetworkValues.LOGLEVEL_DEBUG` `InMobiNetworkValues.LOGLEVEL_ERROR`

Вот пример кода, показывающий, как задать эти параметры запроса рекламы:

Ява

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54);
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345");

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter.class, extras)
   .build();

Котлин

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_54)
extras.putString(InMobiNetworkKeys.AREA_CODE, "12345")

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

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

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

Адаптер InMobi возвращает свои нативные объявления в виде объектов NativeAd . Он заполняет следующие описания полей нативных объявлений для объекта NativeAd .

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

¹ Адаптер InMobi не предоставляет прямого доступа к основному изображению для нативной рекламы. Вместо этого адаптер заполняет MediaView видео или изображением.

Отслеживание показов и кликов

Google Mobile Ads SDK использует обратные вызовы InMobi SDK для отслеживания показов и кликов, поэтому отчеты на обеих панелях управления должны совпадать с минимальными расхождениями или вообще без них.

Коды ошибок

Если адаптеру не удается получить рекламу от InMobi, издатели могут проверить основную ошибку в ответе на рекламу, используя ResponseInfo.getAdapterResponses() в следующих классах:

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

Ниже приведены коды и сопутствующие сообщения, выдаваемые адаптером InMobi, если реклама не загружается:

Код ошибки	Причина
0-99	Ошибки InMobi SDK. Подробнее см. в коде .
100	Параметры сервера InMobi, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
101	Не удалось инициализировать InMobi SDK.
102	Запрошенный размер объявления не соответствует поддерживаемому размеру баннера InMobi.
103	Запрос рекламы не является унифицированным запросом нативной рекламы.
104	Попытка запросить рекламу InMobi без инициализации InMobi SDK. Теоретически этого не должно происходить, поскольку адаптер инициализирует InMobi SDK до запроса рекламы InMobi.
105	Реклама InMobi еще не готова к показу.
106	InMobi не удалось отобразить рекламу.
107	InMobi вернул нативное объявление, в котором отсутствует требуемый актив.
108	В исходных рекламных изображениях InMobi содержится неверный URL-адрес.
109	Адаптеру не удалось загрузить собственные рекламные изображения InMobi.