В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Mintegral с помощью медиации , включая интеграцию каскада и ставок. В нем рассказывается, как добавить Mintegral в конфигурацию медиации рекламного блока, а также как интегрировать Mintegral SDK и адаптер в Unity приложение.
Поддерживаемые интеграции и форматы объявлений
Ad Manager Адаптер-посредник для Mintegral имеет следующие возможности:
Интеграция | |
---|---|
Торги | 1 |
Водопад | 2 |
Форматы | |
Приложение открыто | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением |
2 Интеграция Waterfall находится на стадии закрытого бета-тестирования.
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 5.6 или выше
- [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для Mintegral 1.4.0 или более поздней версии ( рекомендуется последняя версия ).
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий Unity проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Mintegral.
Зарегистрируйтесь или войдите в свою учетную запись Mintegral.
Найдите ключ приложения
Перейдите на вкладку «Настройки приложения» и запишите ключ приложения .
Добавить новое приложение
На вкладке «Настройки приложения» нажмите кнопку «Добавить приложение» .
Выберите платформу и заполните остальную часть формы. Затем нажмите Сохранить .
Андроид
iOS
Запишите идентификатор приложения вашего приложения.
Андроид
iOS
Создать место размещения рекламы
После создания вашей заявки перейдите на вкладку «Места размещения и единицы измерения» и нажмите кнопку «Добавить место размещения», как показано ниже, чтобы создать место размещения вашего объявления.
Андроид
iOS
Введите название места размещения и формат AD .
В качестве типа ставки выберите Header Bidding . Заполните остальную часть формы и нажмите «Сохранить» .
После создания места размещения объявления запишите его идентификатор .
Андроид
iOS
Щелкните раскрывающийся список 1 AD Units и запишите идентификатор AD Unit .
Андроид
iOS
Найдите свой ключ API Mintegral Reporting API
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Вам понадобится ключ Mintegral Reporting API для настройки идентификатора рекламного блока Менеджера рекламы. Перейдите в «Аккаунт» > «Инструменты API» . Запишите свой Skey и Secret .
Шаг 2. Настройте спрос Mintegral в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавлять Mintegral в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках государственного регулирования США , чтобы добавить Mobvista/Mintegral в список рекламных партнеров GDPR и государственного регулирования США в пользовательском интерфейсе Менеджера рекламы.
Шаг 3. Импортируйте Mintegral SDK и адаптер.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Mintegral Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.mintegral
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
. - Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads Mintegral Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина-посредника Google Mobile Ads для Mintegral по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsMintegralMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMintegralMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Добавьте необходимый код
Андроид
Для интеграции Mintegral не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации Mintegral , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5. Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.
Чтобы получить тестовые объявления Mintegral для баннеров, межстраничных объявлений, объявлений с вознаграждением и собственных форматов рекламы, Mintegral рекомендует использовать ключи приложений, идентификаторы приложений, идентификаторы мест размещения и идентификаторы рекламных блоков, представленные на странице идентификаторов тестов Mintegral .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Mintegral, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Mintegral (Biddding) и Mintegral (Waterfall) .
Коды ошибок
Если адаптеру не удается получить объявление от Mintegral, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Вот коды и сопутствующие сообщения, выдаваемые адаптером Mintegral, когда реклама не загружается:
Андроид
Код ошибки | Домен | Причина |
---|---|---|
101 | com.google.ads.mediation.mintegral | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор места размещения). |
102 | com.google.ads.mediation.mintegral | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Mintegral. |
103 | com.google.ads.mediation.mintegral | Отсутствует или недействителен ответ на заявку. |
104 | com.google.ads.mediation.mintegral | Mintegral SDK вернул ошибку отсутствия заполнения. |
iOS
Код ошибки | Домен | Причина |
---|---|---|
101 | com.google.mediation.mintegral | Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор места размещения). |
102 | com.google.mediation.mintegral | Mintegral SDK вернул ошибку отсутствия заполнения. |
103 | com.google.mediation.mintegral | Mintegral SDK не смог показать рекламу. |
104 | com.google.mediation.mintegral | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Mintegral. |
Журнал изменений плагина Mintegral Unity Mediation
Версия 1.8.3
- Поддерживает адаптер Mintegral Android версии 16.8.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.7.3.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 1.8.2
- Поддерживает адаптер Mintegral Android версии 16.8.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.7.2.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.1.
Версия 1.8.1
- Поддерживает адаптер Mintegral Android версии 16.8.51.0 .
- Поддерживает адаптер Mintegral iOS версии 7.7.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.8.0
- Поддерживает адаптер Mintegral Android версии 16.8.31.0 .
- Поддерживает адаптер Mintegral iOS версии 7.7.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.7.0
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает адаптер Mintegral Android версии 16.8.11.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.9.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.6.5
- Поддерживает адаптер Mintegral Android версии 16.7.81.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.6.4
- Поддерживает адаптер Mintegral Android версии 16.7.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.3
- Поддерживает адаптер Mintegral Android версии 16.7.41.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.2
- Поддерживает адаптер Mintegral Android версии 16.7.41.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.1
- Поддерживает адаптер Android Mintegral версии 16.7.21.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.3.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.0
- Поддерживает адаптер Mintegral Android версии 16.7.11.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.5.0
- Поддерживает адаптер Mintegral Android версии 16.6.71.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.4.0
- Поддерживает адаптер Android Mintegral версии 16.6.34.0 .
- Поддерживает адаптер Mintegral iOS версии 7.5.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.7.0.
Версия 1.3.0
- Поддерживает адаптер Mintegral Android версии 16.5.91.0 .
- Поддерживает адаптер Mintegral iOS версии 7.5.3.0 .
- В класс
Mintegral
добавлены следующие методы:-
SetConsentStatus(bool)
-
SetDoNotTrackStatus(bool)
-
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 1.2.1
- Поддерживает адаптер Mintegral Android версии 16.4.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.3.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 1.2.0
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/Mintegral/
. - Поддерживает адаптер Mintegral Android версии 16.4.41.0 .
- Поддерживает адаптер Mintegral iOS версии 7.3.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 1.1.0
- Поддерживает адаптер Mintegral Android версии 16.3.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.2.9.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 1.0.0
- Первый выпуск!
- Поддерживает адаптер Mintegral Android версии 16.2.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.2.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.