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

Интегрируйте InMobi с посредником

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

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

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

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

¹ Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.

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

Требования

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

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

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

Bidding

Select Use InMobi SSP with Google Open Bidding and enter your Google Publisher ID.

Waterfall

No additional step is required for waterfall integrations.

Add an app

To add your app to the InMobi dashboard, click Inventory > Inventory Settings.

Click Add Inventory and select the Mobile App channel from the drop-down menu.

Start typing your published app store URL in the search bar and select the app from the auto-populated results. Click Continue.

If your app in not published, click Link manually and enter the required details. Click Continue.

Review the App & Website Compliance settings and then click Save and Create Placements.

Placements

After you set up your inventory, the system redirects you to the placement creation workflow.

Select the type of ad unit. Then enter a Placement Name, select Off for Audience Bidding, and fill out the rest of the form. Click Create Placement when done.

Once the placement is created, its details are shown. Take note of the Placement ID, which will be used for setting up your Ad Manager ad unit.

Account ID

Your InMobi account ID is available under Finance > Payment Settings > Payment Information.

Locate InMobi Reporting API Key

Go to My Account > Account Settings. Navigate to the API Key tab and click Generate API Key.

Select the email of the user the key is required for and click Generate API Key. A file containing the API key and username/login name will be generated.

Only the publisher administrator of the account will be able to generate an API key for all users. If you have forgotten the previously generated API key, reset your API key by hovering over your mail on the API Key tab.

Turn on test mode

Enable Test Mode for your placement on all live impressions or certain test devices only.

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

登录您的 Ad Manager 帐号。

添加 InMobi 公司

出价

出价集成不需要执行此步骤。

瀑布

依次前往管理 > 公司，然后点击所有公司标签页中的新公司按钮。选择广告联盟。

选择 InMobi 作为广告联盟，输入一个唯一的名称并启用中介。开启自动数据收集，然后输入在上一部分中获得的 Username and API Key。

接下来，输入您的用户名，并在完成后点击保存。

启用安全信号共享

出价

依次前往管理 > 全局设置。前往 Ad Exchange 帐号设置标签页，然后查看并开启安全信号共享。点击保存。

瀑布

广告瀑布流集成不需要执行此步骤。

配置 InMobi 出价

出价

依次前往投放 > 出价方，然后点击 SDK 出价标签页下的新出价方。

选择InMobi作为出价方。

开启将此出价方的信号库添加到允许的信号列表中和允许与此出价方共享信号。然后，点击继续。

点击继续。

点击完成。

瀑布

广告瀑布流集成不需要执行此步骤。

配置广告单元映射

出价

依次前往投放 > 出价方，然后在 SDK 出价标签页下，为InMobi 选择公司。

转到广告单元映射标签页，然后点击新建广告单元映射。

选择特定广告单元。选择一种广告单元和格式，选择移动应用作为广告资源类型，然后选择移动应用。然后，输入在上一部分中获得的Account ID and Placement ID 。最后，点击保存。

瀑布

依次转到投放 > 收益组，然后点击新建收益组按钮。选择您的移动应用。

向下滚动，然后点击添加收益合作伙伴。

选择您在上一部分中为 InMobi创建的公司。选择移动 SDK 中介作为集成类型，选择 Android 作为平台，选择活跃作为状态。

输入在上一部分获得的 Account ID and Placement ID，以及默认 CPM 值。点击保存。

注意：“自动收集数据”功能需要几天时间来收集数据，然后才能准确计算中介广告联盟的动态 CPM 值。可以计算出 eCPM 后，系统会自动为您更新该值。

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

Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить InMobi в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .

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

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

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

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

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство дляAd Manager и включили тестовый режим в пользовательском интерфейсе InMobi .

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

Чтобы убедиться, что вы получаете тестовые объявления отInMobi, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений InMobi (Bidding) and 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, extras)
        .build()

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

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

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

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

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

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

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

Коды ошибок

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

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

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

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