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

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

В этом руководстве показано, как использовать GMA Next-Gen SDK для загрузки и отображения рекламы от Mintegral с помощью медиации , охватывая как каскадную, так и таргетинговую интеграцию. В нем рассказывается, как добавить Mintegral в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Mintegral в приложение для Android.

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

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

Требования

• Android API уровня 24 или выше

• [Для участия в торгах]: Для интеграции всех поддерживаемых форматов объявлений в систему торгов используйте адаптер Mintegral версии 16.5.91.1 или выше ( рекомендуется последняя версия ).

• Новейшая версия GMA Next-Gen SDK .

• Пройдите руководство по началу процесса медиации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновите файл 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.

Войдите в свой аккаунт в Ad Manager .

Добавить Mintegral в список компаний

Включить безопасный обмен сигналами

Передайте защищенный сигнал в запросах на участие в торгах.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Настройка системы торгов Mintegral

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

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

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

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

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

В файл gradle на уровне приложения добавьте следующие зависимости реализации и конфигурации:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mintegral:17.0.81.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:mintegral:17.0.81.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. Чтобы подключить Mintegral SDK, перейдите на страницу Mintegral SDK для Android .

2. Перейдите к артефактам адаптера Mintegral в репозитории Maven от Google. Выберите последнюю версию, загрузите файл .aar адаптера Mintegral и добавьте его в свой проект.

Шаг 4: Внедрите настройки конфиденциальности в SDK Mintegral.

Согласие ЕС и GDPR

В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.

В состав Mintegral SDK входит метод setConsentStatus для передачи информации о согласии в Mintegral SDK.

Приведенный ниже пример кода демонстрирует, как передать информацию о согласии в SDK Mintegral. Эти параметры необходимо установить до инициализации GMA Next-Gen SDK чтобы обеспечить их корректную передачу в SDK Mintegral.

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

Для получения более подробной информации ознакомьтесь с документацией Mintegral по вопросам конфиденциальности .

Законы штатов США о защите частной жизни

Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.

В состав Mintegral SDK входит метод setDoNotTrackStatus для передачи информации о согласии в Mintegral SDK.

Приведенный ниже пример кода демонстрирует, как передать информацию о согласии в SDK Mintegral. Если вам необходимо вызвать этот метод, сделайте это после инициализации GMA Next-Gen SDK но до запроса рекламы через GMA Next-Gen SDK .

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

Для получения более подробной информации ознакомьтесь с документацией Mintegral по вопросам конфиденциальности .

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

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

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

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

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

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

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

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

Дополнительные шаги

Добавить Mintegral в список рекламных партнеров CCPA

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

Нативная реклама

Отображение рекламы

Адаптер Mintegral возвращает нативную рекламу в виде объектов NativeAd . Он заполняет следующие поля для объекта NativeAd .

^1. Адаптер Mintegral не предоставляет прямого доступа к основному графическому ресурсу для своих нативных рекламных объявлений. Вместо этого адаптер заполняет MediaView видео или изображением.

коды ошибок

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

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

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