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

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

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

Выберите платформу: Android (бета-версия)

Android iOS Unity Flutter

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

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

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

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

Требования

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

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

Новейший SDK для мобильной рекламы Google
Заполните руководство по началу медиации.

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

Зарегистрируйте аккаунт в InMobi.

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

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

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

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

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

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

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

Стажировки

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

Торги

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

Водопад

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

После создания рекламного места отобразятся его подробные сведения. Запишите идентификатор рекламного места (Placement ID), который будет использоваться для настройки рекламного блока в вашем Ad Manager.

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

Идентификатор вашей учетной записи 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 для Ad Manager .

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

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

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

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

Войдите в свой аккаунт в Ad Manager .

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

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

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

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

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

Водопад

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

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

Торги

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

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

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

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

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

Водопад

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

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

Торги

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

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

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

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Java

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 из общих настроек. Следуйте инструкциям в документации по законам о конфиденциальности штатов США, чтобы установить строку конфиденциальности США в общих настройках.

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

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

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

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

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

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

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

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

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

Разрешения

Для оптимальной производительности 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`

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

Java

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
Просмотр медиафайлов
Тело
значок приложения
Призыв к действию
Звездный рейтинг
Магазин
Цена

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