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

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

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

Поддерживаемые интеграции и форматы объявлений

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

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

¹ Интеграция назначения ставок находится на стадии открытого бета-тестирования.

² Поддерживается только для каскадной медиации.

Требования

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

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

Шаг 1. Настройте конфигурации в пользовательском интерфейсе InMobi.

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

Как только ваша учетная запись будет подтверждена, войдите в систему .

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

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

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

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

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

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

Размещения

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

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

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

Идентификатор аккаунта

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

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

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

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

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

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

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

Шаг 2. Настройте спрос InMobi в интерфейсе Менеджера рекламы.

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

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

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

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

Торги

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

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

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

Нажмите Продолжить .

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

Водопад

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

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и выберите компанию для InMobi на вкладке «Ставки SDK» .

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

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

Водопад

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

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

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

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

Примечание. Автоматическому сбору данных требуется несколько дней, прежде чем можно будет точно рассчитать значение динамической цены за тысячу показов для сети медиации. Как только эффективная цена за тысячу показов может быть рассчитана, она автоматически обновляется от вашего имени.

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

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

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

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

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

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

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

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

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

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

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

В версии 7.1.0.0 в адаптер InMobi добавлен класс InMobiConsent class that lets you pass consent information to InMobi. The following sample code calls 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 принимает в этом объекте согласия, см. в деталях реализации InMobi GDPR .

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

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

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

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

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

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Менеджере рекламы и включили тестовый режим в пользовательском интерфейсе 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. Адаптер ищет в комплекте следующие ключи:

Параметры и значения запроса
`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.