В этом руководстве показано, как использовать 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.
Зарегистрируйте учетную запись InMobi.
Торги
Выберите «Использовать InMobi SSP с Google Open Bidding» и введите свой идентификатор издателя Google .
Водопад
Для водопадной интеграции не требуется никаких дополнительных действий.
Войдите в свою учетную запись InMobi после проверки.
Добавить приложение
Чтобы добавить свое приложение на панель управления InMobi, нажмите «Инвентарь» > «Настройки инвентаря» .
Нажмите «Добавить инвентарь» и выберите канал мобильного приложения в раскрывающемся меню.
Начните вводить URL-адрес опубликованного магазина приложений в строке поиска и выберите приложение из автоматически заполненных результатов. Нажмите Продолжить .
Если ваше приложение не опубликовано, нажмите «Связать вручную» и введите необходимые данные. Нажмите Продолжить .
Проверьте настройки соответствия приложений и веб-сайтов , а затем нажмите «Сохранить и создать места размещения» .
Размещения
После того как вы настроите свой инвентарь, система перенаправит вас к рабочему процессу создания места размещения.
Торги
Выберите тип рекламного блока. Введите название места размещения , выберите «Вкл» и «Google Open Bidding» для ставок по аудиториям и «Партнер» соответственно и заполните оставшуюся часть формы. Когда закончите, нажмите «Создать место размещения» .
Водопад
Выберите тип рекламного блока. Затем введите название места размещения , выберите «Выкл. для назначения ставок по аудитории » и заполните оставшуюся часть формы. Когда закончите, нажмите «Создать место размещения» .
После создания места размещения отображаются его сведения. Запишите идентификатор места размещения, который будет использоваться для настройки рекламного блокаAdMob .
Идентификатор аккаунта
Идентификатор вашей учетной записи InMobi доступен в разделе «Финансы» > «Настройки платежей» > «Информация о платеже» .
Найдите ключ API отчетов InMobi
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Откройте «Моя учетная запись» > «Настройки учетной записи» . Перейдите на вкладку «Ключ API» и нажмите «Создать ключ API» .
Выберите адрес электронной почты пользователя, для которого требуется ключ, и нажмите «Создать ключ API» . Будет создан файл, содержащий ключ API и имя пользователя/имя для входа.
Только администратор учетной записи издателя сможет сгенерировать ключ API для всех пользователей. Если вы забыли ранее сгенерированный ключ API, сбросьте ключ API, наведя курсор на свою почту на вкладке «Ключ API» .
Включите тестовый режим
Включите тестовый режим для вашего места размещения на всех показах в реальном времени или только на определенных тестовых устройствах.
Шаг 2. Настройте спрос InMobi в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства дляAndroid .
iOS
Инструкции см. в шаге 2 руководства дляiOS .
Добавлять InMobi в соответствии с GDPR и списком рекламных партнеров США.
Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить InMobi в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе AdMob .
Шаг 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
Версия следующая
-
DummyClient
переименован вPlaceholderClient
.
Версия 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.