В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из InMobi с помощью медиации , включая интеграцию водопада и назначения ставок. В нем рассказывается, как добавить InMobi в конфигурацию медиации рекламного блока, а также как интегрировать InMobi SDK и адаптер в Unity приложение.
Поддерживаемые интеграции и форматы объявлений
Интеграция | |
---|---|
Торги | 1 |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден |
1 Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.
Требования
- Последняя версия Google Mobile Ads SDK
- Юнити 4 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 10.0 или выше
- Рабочий Unity проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе InMobi.
Шаг 2. Настройте спрос InMobi в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавлять InMobi в соответствии с GDPR и списком рекламных партнеров США.
Шаг 3. Импортируйте InMobi SDK и адаптер.
Загрузите последнюю версию плагина-посредника Google Mobile Ads для InMobi по ссылке для скачивания в журнале изменений и извлеките GoogleMobileAdsInMobiMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и выберите загруженный вами файл GoogleMobileAdsInMobiMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Ресурсы» > «Resolver служб Play» > «Android Resolver» > «Принудительное разрешение» . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Реализуйте настройки конфиденциальности в InMobi SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей 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 принимает в этом объекте согласия, см. в деталях реализации InMobi GDPR.
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставить пользователям право отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Инструкции по включению настроек CCPA для InMobi см. в документации CCPA InMobi.
Шаг 5. Добавьте необходимый дополнительный код.
Андроид
Никакого дополнительного кода не требуется. Интеграция InMobi.
iOS
Интеграция со SKAdNetwork
Следуйте документации InMobi , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство дляAdMob и включили тестовый режим в пользовательском интерфейсе 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" />
При желании вы можете добавить эти разрешения в файл 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.6.3
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер InMobi Android версии 10.7.5.0 .
- Поддерживает адаптер InMobi iOS версии 10.7.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 4.6.2
- Поддерживает адаптер InMobi Android версии 10.7.4.0 .
- Поддерживает адаптер InMobi iOS версии 10.7.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.1.
Версия 4.6.1
- Поддерживает адаптер InMobi Android версии 10.7.4.0 .
- Поддерживает адаптер InMobi iOS версии 10.7.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 4.6.0
- Поддерживает адаптер InMobi Android версии 10.7.3.0 .
- Поддерживает адаптер InMobi iOS версии 10.7.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 4.5.1
- Поддерживает адаптер InMobi Android версии 10.6.7.1 .
- Поддерживает адаптер InMobi iOS версии 10.7.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 4.5.0
- Поддерживает адаптер InMobi Android версии 10.6.7.1 .
- Поддерживает адаптер InMobi iOS версии 10.7.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 4.4.1
- Поддерживает адаптер InMobi Android версии 10.6.2.0 .
- Поддерживает адаптер InMobi iOS версии 10.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 4.4.0
- Поддерживает адаптер InMobi Android версии 10.6.0.0 .
- Поддерживает адаптер InMobi iOS версии 10.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 4.3.3
- Поддерживает адаптер InMobi Android версии 10.5.8.0 .
- Поддерживает адаптер InMobi iOS версии 10.5.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.5.2.
Версия 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
- Поддерживает адаптер InMobi Android версии 10.1.2.1 .
- Поддерживает адаптер InMobi iOS версии 10.1.2.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 4.2.1
- Поддерживает адаптер InMobi Android версии 10.1.2.0 .
- Поддерживает адаптер InMobi iOS версии 10.1.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.
Версия 4.2.0
- Поддерживает адаптер InMobi Android версии 10.1.1.0 .
- Поддерживает адаптер InMobi iOS версии 10.1.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 4.1.0
- Поддерживает адаптер InMobi Android версии 10.0.9.0 .
- Поддерживает адаптер InMobi iOS версии 10.1.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 4.0.4
- Поддерживает адаптер InMobi Android версии 10.0.7.0 .
- Поддерживает адаптер InMobi iOS версии 10.0.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 4.0.3
- Поддерживает адаптер InMobi Android версии 10.0.5.0 .
- Поддерживает адаптер InMobi iOS версии 10.0.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 4.0.2
- Поддерживает адаптер InMobi Android версии 10.0.3.0 .
- Поддерживает адаптер InMobi iOS версии 10.0.2.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 4.0.1
- Поддерживает адаптер InMobi Android версии 10.0.3.0 .
- Поддерживает адаптер InMobi iOS версии 10.0.2.0 .
Версия 4.0.0
- Поддерживает адаптер InMobi Android версии 10.0.1.0 .
- Поддерживает адаптер InMobi iOS версии 10.0.1.0 .
Версия 3.2.0
- Поддерживает адаптер InMobi Android версии 9.2.0.0 .
- Поддерживает адаптер InMobi iOS версии 9.2.1.0 .
Версия 3.1.2
- Поддерживает адаптер InMobi Android версии 9.1.9.0 .
- Поддерживает адаптер InMobi iOS версии 9.1.7.0 .
Версия 3.1.1
- Поддерживает адаптер InMobi Android версии 9.1.1.0 .
- Поддерживает адаптер InMobi iOS версии 9.1.1.0 .
Версия 3.1.0
- Поддерживает адаптер InMobi Android версии 9.1.0.0 .
- Поддерживает адаптер InMobi iOS версии 9.1.0.0 .
Версия 3.0.3
- Поддерживает адаптер InMobi Android версии 9.0.7.1 .
- Поддерживает адаптер InMobi iOS версии 9.0.7.2 .
Версия 3.0.2
- Поддерживает адаптер InMobi Android версии 9.0.7.0 .
- Поддерживает адаптер InMobi iOS версии 9.0.7.0 .
Версия 3.0.1
- Поддерживает адаптер InMobi Android версии 9.0.6.0 .
- Поддерживает адаптер InMobi iOS версии 9.0.7.0 .
Версия 3.0.0
- Поддерживает адаптер InMobi Android версии 9.0.4.0 .
- Поддерживает адаптер InMobi iOS версии 9.0.4.0 .
Версия 2.4.0
- Поддерживает адаптер InMobi Android версии 7.3.0.1 .
- Поддерживает адаптер InMobi iOS версии 7.4.0.0 .
Версия 2.3.0
- Поддерживает адаптер Android версии 7.2.9.0.
- Поддерживает адаптер iOS версии 7.3.2.0.
Версия 2.2.2
- Обновлен плагин для поддержки нового Rewarded API.
- Поддерживает адаптер 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.