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

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

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

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

Требования

  • Последняя версия Google Mobile Ads SDK
  • Unity 4 или выше
  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы объявлений в торги, используйте плагин медиации Google Mobile Ads для InMobi 4.5.0 или выше ( рекомендуется последняя версия ).
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 10.0 или выше
  • Рабочий проект Unity, настроенный с использованием 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

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

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

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

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

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads InMobi Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:

openupm add com.google.ads.mobile.mediation.inmobi

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

Подробности OpenUPM

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

Выберите пакет Google Mobile Ads InMobi Mediation и нажмите «Установить» .

Установить из OpenUPM

Пакет Unity

Загрузите последнюю версию плагина медиации Google Mobile Ads для InMobi по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsInMobiMediation.unitypackage из zip-файла.

В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsInMobiMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Сила Решения

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

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

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

using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...

Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");

InMobi.UpdateGDPRConsent(consentObject);

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

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

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

Инструкции по включению настроек CCPA для InMobi см. в документации CCPA компании InMobi.

Шаг 5: Добавьте необходимый дополнительный код

Андроид

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

iOS

Интеграция SKAdNetwork

Следуйте документации InMobi , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

Шаг 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" />

При желании вы можете добавить эти разрешения в файл Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml .

iOS

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

Коды ошибок

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

Андроид 

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

iOS 

GADMAdapterInMobi
GADMediationAdapterInMobi

Ниже приведены коды и сопутствующие сообщения, выдаваемые адаптером 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.

iOS

Код ошибки Причина
101 Параметры сервера InMobi, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102 Адаптер InMobi не поддерживает запрашиваемый формат рекламы.
103 Реклама InMobi уже загружена для этой конфигурации сети.
Другой InMobi SDK вернул ошибку. Подробнее см. в IMRequestStatus.h .

Журнал изменений плагина-медиатора InMobi Unity

Версия 4.7.3

Версия 4.7.2

Версия 4.7.1

Версия 4.7.0

Версия 4.6.7

Версия 4.6.6

Версия 4.6.5

Версия 4.6.4

Версия 4.6.3

Версия 4.6.2

Версия 4.6.1

Версия 4.6.0

Версия 4.5.1

Версия 4.5.0

Версия 4.4.1

Версия 4.4.0

Версия 4.3.3

Версия 4.3.0

  • Содержимое адаптера перемещено в GoogleMobileAds/Mediation/InMobi/ .
  • Изменено пространство имен адаптера для использования GoogleMobileAds.Mediation.InMobi .
  • Поддерживает Android-адаптер InMobi версии 10.5.4.1 .
  • Поддерживает адаптер InMobi iOS версии 10.5.4.0 .
  • Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.

Версия 4.2.2

Версия 4.2.1

Версия 4.2.0

Версия 4.1.0

Версия 4.0.4

Версия 4.0.3

Версия 4.0.2

Версия 4.0.1

Версия 4.0.0

Версия 3.2.0

Версия 3.1.2

Версия 3.1.1

Версия 3.1.0

Версия 3.0.3

Версия 3.0.2

Версия 3.0.1

Версия 3.0.0

Версия 2.4.0

Версия 2.3.0

  • Поддерживает Android-адаптер версии 7.2.9.0.
  • Поддерживает адаптер iOS версии 7.3.2.0.

Версия 2.2.2

  • Обновлен плагин для поддержки нового API Rewarded.
  • Поддерживает Android-адаптер версии 7.2.7.0.
  • Поддерживает версию адаптера iOS 7.2.7.0.

Версия 2.2.1

  • Поддерживает Android-адаптер версии 7.2.2.0.
  • Поддерживает версию адаптера iOS 7.2.4.0.

Версия 2.2.0

  • Поддерживает Android-адаптер версии 7.2.1.0.
  • Поддерживает версию адаптера iOS 7.2.0.0.

Версия 2.1.2

  • Поддерживает Android-адаптер версии 7.1.1.1.
  • Поддерживает адаптер iOS версии 7.1.2.0.

Версия 2.1.1

  • Поддерживает Android-адаптер версии 7.1.1.1.
  • Поддерживает версию адаптера iOS 7.1.1.2.

Версия 2.1.0

  • Поддерживает Android-адаптер версии 7.1.0.0.
  • Поддерживает версию адаптера iOS 7.1.1.1.
  • Добавлен метод InMobi.UpdateGDPRConsent() .

Версия 2.0.0

  • Поддерживает версию Android-адаптера 7.0.4.0.
  • Поддерживает адаптер iOS версии 7.1.1.0.

Версия 1.0.0

  • Первый релиз!
  • Поддерживает Android-адаптер версии 6.2.4.0.
  • Поддерживает адаптер iOS версии 6.2.1.0.