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

Выберите платформу: Android iOS Unity Flutter Android (Legacy)

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

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

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

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

Предварительные требования

Прежде чем продолжить, проверьте следующее:

  • Последняя версия Google Mobile Ads Unity Plugin .
  • Версия редактора Unity 5.6 или более поздняя.
  • [For bidding]: To integrate all supported ad formats in bidding, use Google Mobile Ads mediation plugin for Mintegral 1.4.0 or later ( latest version recommended ).
  • Для развертывания на Android
    • Android API уровня 23 или более поздней версии.
  • Для развертывания на iOS
    • Целевая версия iOS — 13.0 или более поздняя.
  • Рабочий проект Unity, настроенный с использованием Google Mobile Ads Unity Plugin . Подробности см. в разделе «Настройка Google Mobile Ads Unity Plugin .
  • Организуйте посредничество .

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

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

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

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

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

From the APP Setting tab, click the Add APP button.

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

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

Once your ad placement is created, take note of the 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 из выпадающего меню.

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

Select the Google Mobile Ads Mintegral Mediation package and click Install .

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

Пакет Unity

Download the latest version of Google Mobile Ads mediation plugin for Mintegral from the download link in the Changelog and extract the GoogleMobileAdsMintegralMediation.unitypackage from the zip file.

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

Импорт из Unity

Then, select Assets > External Dependency Manager > Android Resolver > Force Resolve . The External Dependency Manager library will perform dependency resolution from scratch and copy the declared dependencies into the Assets/Plugins/Android directory of your Unity app.

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

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

Android

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

iOS

Интеграция SKAdNetwork

Follow Mintegral's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

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

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

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

To verify that you are receiving test ads from Mintegral, enable single ad source testing in ad inspector using the Mintegral (Bidding) and Mintegral (Waterfall) ad source(s).

коды ошибок

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

Android 

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

iOS 

GADMediationAdapterMintegral

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

Android

Код ошибки Домен Причина
100 com.mbridge.msdk SDK 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 вернул ошибку "нет заполнения".
105 com.mbridge.msdk Не удалось инициализировать Mintegral SDK.
106 com.google.ads.mediation.mintegral Рекламный ролик слота Mintegral уже загружен и еще не показан.

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.2.4

Версия 2.2.3

Версия 2.2.2

Версия 2.2.1

Версия 2.2.0

Версия 2.1.0

Версия 2.0.6

Версия 2.0.5

Версия 2.0.4

Версия 2.0.3

Версия 2.0.2

Версия 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