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

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

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

В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из InMobi с помощью медиации , охватывая как каскадную модель, так и интеграцию с назначением ставок. В нём также рассказывается, как добавить 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 и «Партнер» соответственно, а затем заполните оставшуюся часть формы. После завершения нажмите «Создать плейсмент-место» .

Водопад

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

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

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

Идентификатор вашего аккаунта 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 в пользовательском интерфейсе Менеджера рекламы

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

Добавить InMobi в компании

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Затем введите свое имя пользователя и нажмите кнопку «Сохранить» .

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите InMobi и включите опцию «Включить интеграцию с приложением» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настройте ставки InMobi

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите InMobi в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для InMobi.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите идентификатор учётной записи и идентификатор места размещения, полученные в предыдущем разделе. Нажмите «Сохранить ».

Водопад

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

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

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

Введите идентификатор аккаунта и идентификатор места размещения, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

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

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

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

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

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

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

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

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

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

Чтобы соответствовать Политике Google в отношении согласия пользователей из ЕС , вы должны предоставить пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определённую информацию и получить их согласие на использование файлов cookie или других локальных хранилищ в случаях, предусмотренных законодательством, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эта политика отражает требования Директивы ЕС о конфиденциальности в электронном виде и Общего регламента по защите данных (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: Проверьте свою реализацию

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

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

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

Чтобы убедиться, что вы получаете тестовые объявления от 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");

AdManagerAdRequest request = new AdManagerAdRequest.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 = AdManagerAdRequest.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, настроенные в пользовательском интерфейсе Менеджера объявлений, отсутствуют или недействительны.
101	Не удалось инициализировать InMobi SDK.
102	Запрошенный размер объявления не соответствует поддерживаемому размеру баннера InMobi.
103	Запрос рекламы не является унифицированным запросом нативной рекламы.
104	Попытка запросить рекламу InMobi без инициализации InMobi SDK. Теоретически этого не должно происходить, поскольку адаптер инициализирует InMobi SDK до запроса рекламы InMobi.
105	Реклама InMobi еще не готова к показу.
106	InMobi не удалось отобразить рекламу.
107	InMobi вернул нативное объявление, в котором отсутствует требуемый актив.
108	В исходных рекламных изображениях InMobi содержится неверный URL-адрес.
109	Адаптеру не удалось загрузить собственные рекламные изображения InMobi.