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

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

Поддерживаемые интеграции и форматы объявлений

AdMob Адаптер-посредник для Mintegral имеет следующие возможности:

Интеграция
Торги
Водопад
Форматы
Приложение открыто	^1
Баннер
Межстраничный
Награжден
Межстраничное объявление с вознаграждением
Родной	^2

¹ Интеграция ставок и водопада для формата открытой рекламы в приложении находится на стадии закрытого бета-тестирования.

² Интеграция ставок и водопада для нативного формата объявлений находится на стадии открытого бета-тестирования.

Требования

• Последняя версия Google Mobile Ads SDK
• Флаттер 3.7.0 или выше
• [Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте плагин посредничества Google Mobile Ads для Mintegral 1.4.0 или более поздней версии ( рекомендуется последняя версия ).
• Развертывание на Android
  • Android API уровня 21 или выше
• Развертывание на iOS
  • Цель развертывания iOS 12.0 или выше
• Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

Андроид

iOS

Запишите идентификатор приложения вашего приложения.

Андроид

iOS

Создать место размещения рекламы

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

Андроид

iOS

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

Важно! Для формата нативного объявления выберите «Нативный (настраиваемый рендеринг)» в качестве формата AD .

Торги

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

Водопад

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

После создания места размещения объявления запишите его идентификатор .

Андроид

iOS

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

Андроид

iOS

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

Торги

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

Водопад

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

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

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

Андроид

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

iOS

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

Добавлять Mintegral в соответствии с GDPR и списком рекламных партнеров США.

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

Следуйте инструкциям в настройках GDPR и настройках государственного регулирования США , чтобы добавить Mobvista/Mintegral в список рекламных партнеров GDPR и государственного регулирования США в пользовательском интерфейсе AdMob.

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

Примечание. Невозможность интеграции совместимых версий Mintegral и Google Mobile Ads SDK может привести к проблемам при сборке.

Интеграция через pub.dev

Добавьте следующую зависимость с последними версиями Mintegral SDK и адаптера в файл pubspec.yaml вашего пакета:

dependencies:
  gma_mediation_mintegral: ^1.0.0

Ручная интеграция

Загрузите последнюю версию плагина-посредника Google Mobile Ads для Mintegral , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:

dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

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

Андроид

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

iOS

Интеграция со SKAdNetwork

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

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

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

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

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

Важно: отключите тестовый режим для AdMob и 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 Flutter Mediation

Следующая версия

• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.

1.1.0

• Проверенная совместимость с адаптером Mintegral Android версии 16.8.31.0.
• Проверенная совместимость с адаптером Mintegral iOS версии 7.7.1.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.

1.0.0

• Первоначальный выпуск.
• Проверена совместимость с адаптером Mintegral Android версии 16.7.21.0.
• Проверенная совместимость с адаптером Mintegral iOS версии 7.6.3.0.
• Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.