Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

Интеграция
Торги
Водопад
Форматы
Открыть приложение
Баннер
Интерстициальный
Награжден
Вознагражденный интерстициальный
Родной

Требования

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

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

Шаг 1: Настройка конфигураций в Mintegral UI

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

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

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

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

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

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

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

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

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

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

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

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

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

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

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

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

Вам необходимо добавить Mintegral в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свой аккаунт AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить Mintegral в качестве источника рекламы» .

Чтобы создать новую группу посредничества, выберите Создать группу посредничества .

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

Дайте название группе медиации и выберите местоположения для таргетинга. Затем установите для группы медиации статус « Включено» и нажмите «Добавить рекламные блоки» .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

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

Торги

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите Mintegral .

Нажмите «Как подписать соглашение о партнерстве» и настроить партнерство по торгам с Mintegral.

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для Mintegral, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .

Затем введите ключ приложения , идентификатор приложения , идентификатор размещения и идентификатор рекламного блока, полученные в предыдущем разделе. Затем нажмите «Готово» .

Водопад

На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

Выберите Mintegral . Затем введите значение eCPM для Mintegral и нажмите «Продолжить» .

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

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

Шаг 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:24.5.0")
    implementation("com.google.ads.mediation:mintegral:16.9.91.1")
}

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

Чтобы включить Mintegral SDK, перейдите по ссылке Mintegral SDK для Android .
Перейдите к артефактам адаптера Mintegral в репозитории Maven от Google. Выберите последнюю версию, скачайте .aar -файл адаптера Mintegral и добавьте его в свой проект.

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

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

Чтобы соответствовать Политике Google в отношении согласия пользователей из ЕС , вы должны предоставить пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определённую информацию и получить их согласие на использование файлов cookie или других локальных хранилищ в случаях, предусмотренных законодательством, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Эта политика отражает требования Директивы ЕС о конфиденциальности в электронном виде и Общего регламента по защите данных (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: Проверьте свою реализацию

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

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

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

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

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

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

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

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

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

Рендеринг рекламы

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

Поле	Активы всегда включены адаптером Mintegral
Заголовок
Изображение	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 вернул ошибку отсутствия заполнения.