В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Mintegral с помощью медиации , охватывая как каскадную модель, так и интеграцию с торгами. В нём также рассказывается, как добавить Mintegral в конфигурацию медиации рекламного блока, а также как интегрировать Mintegral SDK и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы рекламы
Адаптер-медиатор AdMob для Mintegral обладает следующими возможностями:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Открыть приложение | |
Баннер | |
Интерстициальный | |
Награжден | |
Вознагражденный интерстициальный |
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 5.6 или выше
- [Для торгов]: Чтобы интегрировать все поддерживаемые форматы объявлений в торги, используйте плагин посредничества Google Mobile Ads для Mintegral 1.4.0 или выше ( рекомендуется последняя версия ).
- Для развертывания на Android
- Android API уровня 23 или выше
- Для развертывания на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Завершить посредничество . Руководство по началу работы.
Шаг 1: Настройка конфигураций в Mintegral UI
Зарегистрируйтесь или войдите в свою учетную запись Mintegral.
Найдите ключ приложения
Перейдите на вкладку «Настройки приложения» и запишите ключ приложения .
Добавить новое приложение
На вкладке «Настройки приложения» нажмите кнопку «Добавить приложение» .
Выберите платформу и заполните оставшуюся часть формы. Затем нажмите «Сохранить» .
Андроид
iOS
Запишите идентификатор приложения (APP ID) вашего приложения.
Андроид
iOS
Создать место размещения рекламы
После создания заявки перейдите на вкладку «Места размещения и единицы» и нажмите кнопку «Добавить место размещения», как показано ниже, чтобы создать место размещения рекламы.
Андроид
iOS
Введите название места размещения и формат объявления .
Торги
Выберите «Тип торгов» ( Header Bidding) . Заполните оставшуюся часть формы и нажмите «Сохранить» .
Водопад
Выберите тип торгов «Водопад» . Заполните оставшуюся часть формы и нажмите «Сохранить» .
После создания места размещения рекламы запишите идентификатор места размещения .
Андроид
iOS
Нажмите на раскрывающийся список 1 AD Units и запишите идентификатор AD Unit .
Андроид
iOS
Найдите свой ключ API Mintegral Reporting
Торги
Этот шаг не требуется для интеграции торгов.
Водопад
Для настройки идентификатора рекламного блока AdMob вам понадобится ключ API Mintegral Reporting. Перейдите в раздел «Учётная запись» > «Инструменты API» . Запишите ключ Skey и секретный ключ Secret .
Обновите файл app-ads.txt
Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt
. Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .
Чтобы реализовать app-ads.txt
для Mintegral, ознакомьтесь с разделом «Как app-Ads.txt может помочь в борьбе с мошенничеством с рекламой» .
Шаг 2: Настройте Mintegral Demand в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте Mobvista/Mintegral в список рекламных партнеров, соответствующих GDPR и государственным нормам США.
Следуйте инструкциям в настройках европейских и государственных нормативных актов США, чтобы добавить Mobvista/Mintegral в список рекламных партнеров, соответствующих европейским и государственным нормативным актам США, в пользовательском интерфейсе AdMob.
Шаг 3: Импортируйте Mintegral SDK и адаптер
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Mintegral Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.mintegral
OpenUPM
В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .
На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
- Область(ы):
com.google
Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.
Выберите пакет Google Mobile Ads Mintegral Mediation и нажмите «Установить» .
Пакет Unity
Загрузите последнюю версию плагина медиации Google Mobile Ads для Mintegral по ссылке в журнале изменений и извлеките пакет GoogleMobileAdsMintegralMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMintegralMediation.unitypackage
. Убедитесь, что выбраны все файлы, и нажмите «Импорт» .
Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4: Добавьте необходимый код
Андроид
Для интеграции Mintegral дополнительный код не требуется.
iOS
Интеграция SKAdNetwork
Следуйте документации Mintegral , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 5: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob.
Чтобы получить тестовые объявления Mintegral для баннеров, полноэкранной рекламы, объявлений с вознаграждением и нативных форматов, Mintegral рекомендует использовать ключи приложений, идентификаторы приложений, идентификаторы мест размещения и идентификаторы рекламных блоков, предоставленные на странице идентификаторов тестов Mintegral .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Mintegral, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Mintegral (Bidding) и 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.9.3
- Поддерживает интегрированный Android-адаптер версии 16.9.71.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.2.0.
Версия 1.9.2
- Поддерживает интегрированный Android-адаптер версии 16.9.71.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.1.0.
Версия 1.9.1
- Поддерживает интегрированный Android-адаптер версии 16.9.61.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.0.0.
Версия 1.9.0
- Поддерживает интегрированный адаптер Android версии 16.9.51.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 10.0.0.
Версия 1.8.4
- Поддерживает интегрированный Android-адаптер версии 16.8.61.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.5.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.5.0.
Версия 1.8.3
- Поддерживает интегрированный Android-адаптер версии 16.8.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.7.3.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 1.8.2
- Поддерживает интегрированный Android-адаптер версии 16.8.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.7.2.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.1.
Версия 1.8.1
- Поддерживает интегрированный Android-адаптер версии 16.8.51.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.8.0
- Поддерживает интегрированный адаптер Android версии 16.8.31.0 .
- Поддерживает интегрированный адаптер iOS версии 7.7.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.7.0
-
DummyClient
переименован вPlaceholderClient
. - Поддерживает интегрированный адаптер Android версии 16.8.11.0 .
- Поддерживает интегрированный адаптер iOS версии 7.6.9.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.6.5
- Поддерживает интегрированный адаптер Android версии 16.7.81.0 .
- Поддерживает интегрированный адаптер iOS версии 7.6.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 1.6.4
- Поддерживает интегрированный адаптер Android версии 16.7.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.7.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.3
- Поддерживает интегрированный адаптер Android версии 16.7.41.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.2
- Поддерживает интегрированный адаптер Android версии 16.7.41.0 .
- Поддерживает интегрированный адаптер iOS версии 7.6.4.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.1
- Поддерживает интегрированный адаптер Android версии 16.7.21.0 .
- Поддерживает интегрированный адаптер iOS версии 7.6.3.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 1.6.0
- Поддерживает интегрированный адаптер Android версии 16.7.11.0 .
- Поддерживает адаптер Mintegral iOS версии 7.6.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.5.0
- Поддерживает интегрированный Android-адаптер версии 16.6.71.0 .
- Поддерживает интегрированный адаптер iOS версии 7.6.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 1.4.0
- Поддерживает интегрированный адаптер Android версии 16.6.34.0 .
- Поддерживает адаптер Mintegral iOS версии 7.5.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.7.0.
Версия 1.3.0
- Поддерживает интегрированный адаптер Android версии 16.5.91.0 .
- Поддерживает интегрированный адаптер iOS версии 7.5.3.0 .
- Добавлены следующие методы в класс
Mintegral
:-
SetConsentStatus(bool)
-
SetDoNotTrackStatus(bool)
-
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.6.0.
Версия 1.2.1
- Поддерживает интегрированный Android-адаптер версии 16.4.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.3.8.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 1.2.0
- Содержимое адаптера перемещено в
GoogleMobileAds/Mediation/Mintegral/
. - Поддерживает интегрированный адаптер Android версии 16.4.41.0 .
- Поддерживает интегрированный адаптер iOS версии 7.3.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.3.0.
Версия 1.1.0
- Поддерживает интегрированный Android-адаптер версии 16.3.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.2.9.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 1.0.0
- Первый выпуск!
- Поддерживает интегрированный адаптер Android версии 16.2.61.0 .
- Поддерживает адаптер Mintegral iOS версии 7.2.6.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.1.