Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

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

Интеграция Mintegral с назначением ставок (бета)

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

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

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

The mediation adapter for Mintegral has the following capabilities:

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

^1. Интеграция системы торгов находится в стадии открытого бета-тестирования.

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

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

Android API уровня 23 или более поздней версии.

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

Последняя версия Google Mobile Ads SDK (Legacy) .
Организуйте посредничество .

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

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

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

Navigate to the APP Setting tab and take note of the APP Key .

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

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

Select the Platform and fill out the rest of the form. Then, click Save .

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

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

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

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

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

Once your ad placement is created, take note of the Placement ID .

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

Найдите свой ключ 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 .

To implement app-ads.txt for Mintegral, see How app-Ads.txt Can Help Fight Ad Fraud .

Шаг 2: Настройте требования Mintegral в пользовательском интерфейсе Ad Manager.

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

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

Торги

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

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Выберите Mintegral в качестве рекламной сети , введите уникальное имя и включите медиацию .

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

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

Торги

Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи Ad Exchange , просмотрите и включите параметр «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Navigate to Inventory > Secure Signals . Under Secure signals , search for Mobvista/Mintegral and turn on Enable app integration .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите « Сохранить ».

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите компанию Mintegral в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

Нажмите «Готово» .

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Выберите компанию для Mintegral.

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Создать новое сопоставление рекламных блоков» .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и укажите ваше мобильное приложение . Затем введите ключ приложения , идентификатор приложения , идентификатор размещения и идентификатор рекламного блока , полученные в предыдущем разделе.

Наконец, нажмите «Сохранить» .

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» . Выберите свой склад и приложение .

Прокрутите страницу до раздела «Партнёры по доходности» и нажмите «Добавить партнёра по доходности» .

Select the company you created for Mintegral in the previous section. Choose Mobile SDK mediation as the Integration type , Android as the Platform , and Active as the Status .

Введите ключ приложения , идентификатор приложения , идентификатор размещения и идентификатор рекламного блока , полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Add Mobvista/Mintegral to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Mobvista/Mintegral to the European and US state regulations ad partners list in the Ad Manager UI.

Шаг 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")
    }
  }
}

In your app-level gradle file, add the following implementation dependencies:

Котлин

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:mintegral:17.1.81.0")
}

Классный

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:mintegral:17.1.81.0'
}

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

Чтобы подключить Mintegral SDK, перейдите на страницу Mintegral SDK для Android .
Navigate to the Mintegral adapter artifacts on Google's Maven Repository. Select the latest version, download the Mintegral adapter's .aar file, and add it to your project.

Step 4: Implement privacy settings on Mintegral SDK

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

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

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

Приведенный ниже пример кода демонстрирует, как передать информацию о согласии в SDK Mintegral. Эти параметры необходимо установить до инициализации Google Mobile Ads SDK (Legacy) чтобы обеспечить их корректную передачу в SDK Mintegral.

Java

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

Котлин

val sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)MintegralMediationSnippets.kt

See Mintegral's privacy documentation for more information.

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

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

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

Приведенный ниже пример кода демонстрирует, как передать информацию о согласии в SDK Mintegral. Если вам необходимо вызвать этот метод, сделайте это после инициализации Google Mobile Ads SDK (Legacy) , но до запроса рекламы через Google Mobile Ads SDK (Legacy) .

Java

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

Котлин

val sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setDoNotTrackStatus(false)MintegralMediationSnippets.kt

See Mintegral's privacy documentation for more information.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поле	Активы всегда включены в адаптер Mintegral.
Заголовок
Изображение	1
Тело
Икона
Призыв к действию
Звездный рейтинг
Магазин
Цена
Рекламодатель

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

коды ошибок

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

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

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

Код ошибки	Домен	Причина
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 уже загружен и еще не показан.

Список изменений адаптера Mintegral Android Mediation