Интегрируйте Mintegral с медиацией

Выберите платформу: Android (бета-версия)Новый Android iOS Unity Flutter

В этом руководстве показано, как использовать плагин Google Mobile Ads Unity для загрузки и отображения объявлений от Mintegral с помощью медиации , охватывая как каскадную, так и таргетинговую интеграцию. В нем рассказывается, как добавить Mintegral в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Mintegral в приложение Unity.

Поддерживаемые интеграции и форматы рекламы

Адаптер медиации Ad Manager для Mintegral обладает следующими возможностями:

Интеграция
Торги 1
Водопад
Форматы
Приложение открыто
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
1. Интеграция системы торгов находится в стадии открытого бета-тестирования.

Требования

  • Новейший плагин Google Mobile Ads для Unity
    • Unity 5.6 или выше
    • [Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему торгов, используйте плагин медиации Google Mobile Ads для Mintegral версии 1.4.0 или выше ( рекомендуется последняя версия ).
    • Для развертывания на Android
      • Android API уровня 23 или выше
    • Для развертывания на iOS
      • Целевая версия iOS для развертывания — 12.0 или выше.
    • Рабочий проект Unity, настроенный с использованием плагина Google Mobile Ads Unity. Подробности см. в разделе «Начало работы» .
    • Заполните руководство по началу медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе Mintegral.

Зарегистрируйтесь или войдите в свою учетную запись Mintegral.

Найдите ключ приложения.

Перейдите во вкладку «Настройки приложения» и запишите ключ приложения .

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

На вкладке «Настройки приложения» нажмите кнопку «Добавить приложение» .

Выберите платформу и заполните остальную часть формы. Затем нажмите «Сохранить» .

Android

iOS

Запишите идентификатор приложения (APP ID) .

Android

iOS

Создать рекламное место

После создания приложения перейдите на вкладку «Размещения и блоки» и нажмите кнопку «Добавить размещение» , как показано ниже, чтобы создать место размещения рекламы.

Android

iOS

Введите название места размещения и формат объявления .

Выберите Header Bidding в качестве типа торгов . Заполните остальную часть формы и нажмите «Сохранить» .

После создания рекламного места запишите идентификатор места размещения (Placement ID ).

Android

iOS

Щелкните раскрывающийся список «1 AD Units» и запишите идентификатор AD Unit .

Android

iOS

Найдите свой ключ API для Mintegral Reporting.

Торги

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

Водопад

Для настройки идентификатора рекламного блока в Ad Manager вам понадобится ключ API Mintegral Reporting. Перейдите в раздел «Аккаунт» > «Инструменты API» . Запишите свой ключ и секретный ключ .

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Чтобы внедрить файл app-ads.txt в Mintegral, см. раздел «Как app-Ads.txt может помочь в борьбе с мошенничеством в сфере рекламы» .

Шаг 2: Настройте требования Mintegral в пользовательском интерфейсе Ad Manager.

Настройте параметры медиации для вашего рекламного блока.

Android

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

Добавить Mobvista/Mintegral в список рекламных партнеров, соответствующих требованиям GDPR и законодательства штатов США.

Чтобы добавить Mobvista/Mintegral в список рекламных партнеров , соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований .

Шаг 3: Импортируйте SDK и адаптер Mintegral.

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI , вы можете установить плагин Google Mobile Ads Mintegral Mediation для Unity в свой проект, выполнив следующую команду из корневого каталога проекта:

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

В редакторе проекта Unity выберите Edit > Project Settings > Package Manager , чтобы открыть настройки менеджера пакетов Unity .

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

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Область применения: com.google

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

Затем перейдите в меню Window > Package Manager , чтобы открыть диспетчер пакетов Unity , и выберите My Registries из выпадающего меню.

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

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

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

Пакет Unity

Загрузите последнюю версию плагина Google Mobile Ads Mediation для Mintegral по ссылке для скачивания в Changelog и извлеките файл GoogleMobileAdsMintegralMediation.unitypackage из zip-архива.

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

Импорт из Unity

Затем выберите Assets > External Dependency Manager > Android Resolver > Force Resolve . Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Силовое разрешение

Шаг 4: Добавьте необходимый код

Android

Для интеграции с Mintegral дополнительный код не требуется.

iOS

Интеграция SKAdNetwork

Чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта, следуйте документации Mintegral .

Шаг 5: Протестируйте свою реализацию.

Включить тестовые объявления

Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.

Для запуска тестовых объявлений Mintegral для баннеров, межстраничных объявлений, объявлений с вознаграждением и нативных объявлений, Mintegral рекомендует использовать ключи приложений, идентификаторы приложений, идентификаторы мест размещения и идентификаторы рекламных блоков, указанные на странице тестовых идентификаторов Mintegral .

Проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от Mintegral, включите тестирование по одному источнику объявлений в инспекторе объявлений, используя источники объявлений Mintegral (Bidding) и Mintegral (Waterfall) .

коды ошибок

Если адаптер не получает объявление от Mintegral, издатели могут проверить основную причину ошибки в ответе на объявление, используя ResponseInfo в следующих классах:

Android 

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

iOS 

GADMediationAdapterMintegral

Вот коды ошибок и соответствующие сообщения, которые выдает адаптер Mintegral при неудачной загрузке рекламы:

Android

Код ошибки Домен Причина
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

Версия 2.0.1

Версия 2.0.0

Версия 1.9.8

Версия 1.9.7

Версия 1.9.6

Версия 1.9.5

Версия 1.9.4

Версия 1.9.3

Версия 1.9.2

Версия 1.9.1

Версия 1.9.0

Версия 1.8.4

Версия 1.8.3

Версия 1.8.2

Версия 1.8.1

Версия 1.8.0

Версия 1.7.0

Версия 1.6.5

Версия 1.6.4

Версия 1.6.3

Версия 1.6.2

Версия 1.6.1

Версия 1.6.0

Версия 1.5.0

Версия 1.4.0

Версия 1.3.0

Версия 1.2.1

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0