В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Mintegral с помощью посредничество , охватывающую интеграцию каскада и ставок. В нем рассказывается, как добавить Mintegral в конфигурацию медиации рекламного блока, а также как интегрировать Mintegral SDK и адаптер вAndroid приложение.
Поддерживаемые интеграции и форматы объявлений
Адаптер-посредник для Mintegral имеет следующие возможности:
Интеграция | |
---|---|
Торги | 1 |
Водопад | 2 |
Форматы | |
Приложение открыто | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением | |
Родной |
2 Интеграция Waterfall находится на стадии закрытого бета-тестирования.
Требования
- Android API уровня 21 или выше
Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Mintegral.
Зарегистрируйтесь или войдите в свою учетную запись Mintegral.
Найдите ключ приложения
Перейдите на вкладку «Настройки приложения» и запишите ключ приложения .
Добавить новое приложение
На вкладке «Настройки приложения» нажмите кнопку «Добавить приложение» .
Выберите платформу и заполните остальную часть формы. Затем нажмите Сохранить .
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/new_application_Android.png?authuser=6&hl=ru)
Запишите идентификатор приложения вашего приложения.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/app_id_Android.png?authuser=6&hl=ru)
Создать место размещения рекламы
После создания вашей заявки перейдите на вкладку «Места размещения и единицы измерения» и нажмите кнопку «Добавить место размещения» , как показано ниже, чтобы создать место размещения вашего объявления.
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/create_placement_Android.png?authuser=6&hl=ru)
Введите название места размещения и формат AD .
В качестве типа ставки выберите Header Bidding . Заполните остальную часть формы и нажмите «Сохранить» .
После создания места размещения объявления запишите его идентификатор .
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/ad_placement_id_Android.png?authuser=6&hl=ru)
Щелкните раскрывающийся список 1 AD Units и запишите идентификатор AD Unit .
![](https://developers-dot-devsite-v2-prod.appspot.com/admob/images/mediation/mintegral/add_ad_unit_id_Android.png?authuser=6&hl=ru)
Найдите свой ключ API Mintegral Reporting API
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Вам понадобится ключ API Mintegral Reporting для настройки идентификатора рекламного блокаAd Manager . Перейдите в «Аккаунт» > «Инструменты API» . Запишите свой Skey и Secret .
Шаг 2. Настройте спрос Mintegral в Ad Manager пользовательский интерфейс
Войдите в свою учетную запись Менеджера рекламы .
Добавьте Mintegral в компании
Торги
Этот шаг не требуется для интеграции ставок.
Водопад
Перейдите в «Администратор » > «Компании» , затем нажмите кнопку « Новая компания» на вкладке «Все компании» . Выберите Рекламную сеть .
Выберите Mintegral в качестве рекламной сети , введите уникальное имя и включите посредничество .
Вам не нужно вводить имя пользователя или пароль . Нажмите «Сохранить» , когда закончите.
Включить безопасный обмен сигналами
Торги
Перейдите в «Администратор» > «Глобальные настройки» . Перейдите на вкладку настроек аккаунта Ad Exchange , проверьте и включите параметр «Безопасный обмен сигналами ». Нажмите Сохранить .
Водопад
Этот шаг не требуется для каскадной интеграции.
Настройка ставок Mintegral
Торги
Перейдите в раздел «Доставка » > «Участники торгов» и нажмите «Новый участник торгов» на вкладке «Ставки SDK» .
Выберите Mintegral в качестве участника торгов.
Включите параметр «Добавить библиотеку сигналов этой системы назначения ставок в список разрешенных сигналов» и «Разрешить передачу сигналов этой системе назначения ставок» . Затем нажмите Продолжить .
Нажмите Продолжить .
Нажмите Готово .
Водопад
Этот шаг не требуется для каскадной интеграции.
Настройка сопоставления рекламных блоков
Торги
Перейдите в раздел Доставка > Участники торгов и выберите компанию дляMintegral на вкладке SDK Bidding .
Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Новое сопоставление рекламных блоков» .
Выберите Конкретный рекламный блок . Выберите рекламный блок и формат, Мобильное приложение в качестве типа инвентаря и свое мобильное приложение . Затем введитеApp Key, App ID, Placement ID, and Ad Unit ID полученный в предыдущем разделе. Наконец, нажмите «Сохранить» .
Водопад
Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» . Выберите свое мобильное приложение .
Прокрутите вниз и нажмите «Добавить партнера по доходности ».
Выберите компанию, которую вы создали для Mintegralв предыдущем разделе. Выберите «Медиация Mobile SDK» в качестве «Тип интеграции» , Android в качестве «Платформа » и «Активный» в качестве « Состояние» .
Введите App Key, App ID, Placement ID, and Ad Unit IDполученный в предыдущем разделе, и значение цены за тысячу показов по умолчанию . Нажмите Сохранить .
Добавлять Mintegral в соответствии с GDPR и списком рекламных партнеров США.
Выполните действия, описанные вНастройки GDPRиНастройки правил штата США, чтобы добавить Mintegral в список рекламных партнеров GDPR и правил штата США. в пользовательском интерфейсе Ad Manager .
Шаг 3. Импортируйте Mintegral SDK и адаптер.
Интеграция с Android Studio (рекомендуется)
В файле settings.gradle.kts
уровня проекта добавьте следующие репозитории:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Затем в файл build.gradle.kts
уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии Mintegral SDK и адаптера:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.11.0")
}
Ручная интеграция
Чтобы включить Mintegral SDK, перейдите на страницу Mintegral SDK для Android .
Перейдите к артефактам адаптера Mintegral в репозитории Google Maven. Выберите последнюю версию, загрузите файл
.aar
адаптера Mintegral и добавьте его в свой проект.
Шаг 4. Внедрите настройки конфиденциальности в Mintegral SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Mintegral SDK включает метод setConsentStatus
для передачи информации о согласии в Mintegral SDK.
В следующем примере кода показано, как передать информацию о согласии в Mintegral SDK. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK, чтобы обеспечить их правильную пересылку в Mintegral SDK.
Ява
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.
В следующем примере кода показано, как передать информацию о согласии в Mintegral SDK. Если вам нужно вызвать этот метод, вызовите егопослеинициализация Google Mobile Ads SDKно перед запросом рекламы через Google Mobile Ads 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 Test ID .
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления отMintegral, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Mintegral (Bidding) and Mintegral (Waterfall) .
Дополнительные шаги
Добавить Mintegral в список рекламных партнеров CCPA
Следуйте инструкциям вНастройки CCPAдобавить Mintegral в список рекламных партнеров CCPA вAd Manager Пользовательский интерфейс.
Нативная реклама
Рендеринг рекламы
Адаптер Mintegral возвращает нативную рекламу какNativeAd
объекты. Он заполняет следующиеполядляNativeAd
.
Поле | Активы, всегда включенные в адаптер Mintegral |
---|---|
Заголовок | |
Изображение | 1 |
Тело | |
Икона | |
Призыв к действию | |
Звездный рейтинг | |
Магазин | |
Цена | |
Рекламодатель |
1 Адаптер Mintegral не обеспечивает прямой доступ к основному изображению для своих собственных объявлений. Вместо этого адаптер заполняетMediaView
с видео или изображением.
Коды ошибок
Если адаптеру не удается получить объявление от Mintegral, вы можете проверить основную ошибку из ответа на объявление, используяResponseInfo.getAdapterResponses()
по следующим классам:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Вот коды и сопутствующие сообщения, выдаваемые адаптером 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 вернул ошибку отсутствия заполнения. |
Журнал изменений адаптера Mintegral Android Mediation
Версия 16.8.11.0
- Проверенная совместимость с Mintegral SDK 16.8.11.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.2.0.
- Mintegral SDK версии 16.8.11.
Версия 16.7.91.0
- Проверена совместимость с Mintegral SDK 16.7.91.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.2.0.
- Mintegral SDK версии 16.7.91.
Версия 16.7.81.0
- Проверена совместимость с Mintegral SDK 16.7.81.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.2.0.
- Mintegral SDK версии 16.7.81.
Версия 16.7.71.0
- Проверена совместимость с Mintegral SDK 16.7.71.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.1.0.
- Mintegral SDK версии 16.7.71.
Версия 16.7.61.0
- Проверена совместимость с Mintegral SDK 16.7.61.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.1.0.
- Mintegral SDK версии 16.7.61.
Версия 16.7.51.0
- Проверена совместимость с Mintegral SDK 16.7.51.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.1.0.
- Mintegral SDK версии 16.7.51.
Версия 16.7.41.0
- Проверена совместимость с Mintegral SDK 16.7.41.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.1.0.
- Mintegral SDK версии 16.7.41.
Версия 16.7.31.0
- Проверена совместимость с Mintegral SDK 16.7.31.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.1.0.
- Mintegral SDK версии 16.7.31.
Версия 16.7.21.0
- Проверенная совместимость с Mintegral SDK 16.7.21.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- Mintegral SDK версии 16.7.21.
Версия 16.7.11.0
- Проверенная совместимость с Mintegral SDK 16.7.11.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- Mintegral SDK версии 16.7.11.
Версия 16.6.71.0
- Проверенная совместимость с Mintegral SDK 16.6.71.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- Mintegral SDK версии 16.6.71.
Версия 16.6.61.0
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 23.0.0.
- Проверена совместимость с Mintegral SDK 16.6.61.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 23.0.0.
- Mintegral SDK версии 16.6.61.
Версия 16.6.51.0
- Проверена совместимость с Mintegral SDK 16.6.51.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- Mintegral SDK версии 16.6.51.
Версия 16.6.41.0
- Проверена совместимость с Mintegral SDK 16.6.41.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- Mintegral SDK версии 16.6.41.
Версия 16.6.34.0
- Проверенная совместимость с Mintegral SDK 16.6.34.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- Mintegral SDK версии 16.6.34.
Версия 16.6.21.0
- Проверена совместимость с Mintegral SDK 16.6.21.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- Mintegral SDK версии 16.6.21.
Версия 16.5.91.1
- Добавлена поддержка ставок для формата объявлений при открытии приложения.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- Mintegral SDK версии 16.5.91.
Версия 16.5.91.0
- Проверена совместимость с Mintegral SDK 16.5.91.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 22.6.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.6.0.
- Mintegral SDK версии 16.5.91.
Версия 16.5.51.0
- Проверена совместимость с Mintegral SDK 16.5.51.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.3.0.
- Mintegral SDK версии 16.5.51.
Версия 16.5.41.0
- Проверена совместимость с Mintegral SDK 16.5.41.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.3.0.
- Mintegral SDK версии 16.5.41.
Версия 16.5.31.0
- Проверена совместимость с Mintegral SDK 16.5.31.
- Адаптер снова стал зависеть от Google Mobile Ads SDK версии 22.3.0.
- Добавлена поддержка водопада для формата объявления при открытии приложения.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.3.0.
- Mintegral SDK версии 16.5.31.
Версия 16.5.21.0
- Проверенная совместимость с Mintegral SDK 16.5.21.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 22.4.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.4.0.
- Mintegral SDK версии 16.5.21.
Версия 16.5.11.0
- Добавлена поддержка водяных знаков для объявлений с назначением ставок.
- Проверенная совместимость с Mintegral SDK 16.5.11.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.2.0.
- Mintegral SDK версии 16.5.11.
Версия 16.4.91.0
- Проверенная совместимость с Mintegral SDK 16.4.91.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.2.0.
- Mintegral SDK версии 16.4.91.
Версия 16.4.81.0
- Проверена совместимость с Mintegral SDK 16.4.81.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.2.0.
- Mintegral SDK версии 16.4.81.
Версия 16.4.71.0
- Проверена совместимость с Mintegral SDK 16.4.71.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.2.0.
- Mintegral SDK версии 16.4.71.
Версия 16.4.61.0
- Проверена совместимость с Mintegral SDK 16.4.61.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.1.0.
- Mintegral SDK версии 16.4.61.
Версия 16.4.51.0
- Проверена совместимость с Mintegral SDK 16.4.51.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.1.0.
- Mintegral SDK версии 16.4.51.
Версия 16.4.41.0
- Исправлена проблема, из-за которой рекламные баннеры отображались с неправильными размерами.
- Проверенная совместимость с Mintegral SDK 16.4.41.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.0.0.
- Mintegral SDK версии 16.4.41.
Версия 16.4.31.0
- Проверена совместимость с Mintegral SDK 16.4.31.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.0.0.
- Mintegral SDK версии 16.4.31.
Версия 16.4.21.0
- Обновлен адаптер для использования нового класса
VersionInfo
. - Минимальная необходимая версия Google Mobile Ads SDK обновлена до 22.0.0.
- Проверенная совместимость с Mintegral SDK 16.4.21.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 22.0.0.
- Mintegral SDK версии 16.4.21.
Версия 16.3.91.0
- Проверенная совместимость с Mintegral SDK 16.3.91.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.5.0.
- Mintegral SDK версии 16.3.91.
Версия 16.3.81.0
- Проверена совместимость с Mintegral SDK 16.3.81.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.5.0.
- Mintegral SDK версии 16.3.81.
Версия 16.3.71.0
- Проверена совместимость с Mintegral SDK 16.3.71.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.5.0.
- Mintegral SDK версии 16.3.71.
Версия 16.3.61.0
- Проверенная совместимость с Mintegral SDK 16.3.61.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.5.0.
- Mintegral SDK версии 16.3.61.
Версия 16.3.51.1
- Добавлена каскадная поддержка форматов баннеров (включая MREC), межстраничных объявлений, объявлений с вознаграждением и нативной рекламы.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 21.5.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.5.0.
- Mintegral SDK версии 16.3.51.
Версия 16.3.51.0
- Проверена совместимость с Mintegral SDK 16.3.51.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.4.0.
- Mintegral SDK версии 16.3.51.
Версия 16.3.41.0
- Проверенная совместимость с Mintegral SDK 16.3.41.
- Минимальная необходимая версия Google Mobile Ads SDK обновлена до 21.4.0.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.4.0.
- Mintegral SDK версии 16.3.41.
Версия 16.3.11.0
- Проверенная совместимость с Mintegral SDK 16.3.11.
- Обновлен адаптер для пересылки
onUserEarnedReward()
передonAdClosed()
при показе рекламы с вознаграждением.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.3.0.
- Mintegral SDK версии 16.3.11.
Версия 16.2.61.0
- Первый выпуск!
- Добавлена поддержка ставок для форматов баннеров (включая MREC), межстраничных объявлений, объявлений с вознаграждением и нативных объявлений.
Создан и протестирован с использованием:
- Google Mobile Ads SDK версии 21.3.0.
- Mintegral SDK версии 16.2.61.