Интегрируйте 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. При создании учетной записи не ставьте галочку напротив опции Use InMobi SSP with Google Open Bidding .

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

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

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

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

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

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

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

Размещения

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

Торги

Выберите тип рекламного блока. Введите Placement Name , выберите On и Google Open Bidding для Audience Bidding и Partner соответственно, и заполните остальную часть формы. Нажмите Create Placement, когда закончите.

Водопад

Выберите тип рекламного блока. Затем введите Placement Name , выберите Off для Audience Bidding и заполните остальную часть формы. Нажмите Create Placement, когда закончите.

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

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

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

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

Торги

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

Водопад

Перейдите в Мой аккаунт > Настройки аккаунта . Перейдите на вкладку Ключ API и нажмите Сгенерировать ключ API .

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

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

Обновите свой 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 .

На вкладке «Реестры с ограниченной областью действия» добавьте OpenUPM как реестр с ограниченной областью действия со следующими данными:

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

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

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

Реестры единства

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

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

Пакет «Единство»

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

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный вами файл GoogleMobileAdsInMobiMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите Import .

Импорт из 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 Mediation

Версия 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 .
  • Поддерживает адаптер InMobi Android версии 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.