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

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

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

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

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

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

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

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

Требования

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

Новейший Google Mobile Ads SDK .
Пройдите руководство по началу процесса медиации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

Водопад

You will need your Mintegral Reporting API Key for setting up your Ad Manager ad unit ID. Navigate to Account > API Tools . Take note of your Skey and Secret .

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

Торги

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

Водопад

Navigate to Admin > Companies , then click the New company button in the All companies tab. Select Ad network .

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

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

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

Торги

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

Водопад

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

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

Торги

Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите Mobvista/Mintegral и включите параметр «Включить интеграцию с приложением» .

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

Водопад

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

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

Торги

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

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

Водопад

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

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

Торги

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

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

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

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

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

Водопад

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

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

Торги

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

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

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

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

Водопад

Navigate to Delivery > Yield groups and click the New yield group button. Select your Mobile application .

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

Выберите компанию, которую вы создали для Mintegral в предыдущем разделе. В качестве типа интеграции выберите «Посредничество мобильного SDK» , в качестве платформы — «iOS» , а в качестве статуса — «Активный» .

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

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

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

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

Используйте менеджер пакетов Swift.

Прежде чем продолжить, у вас должна быть установлена минимальная поддерживаемая версия адаптера 7.7.9.0.

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

In Xcode, navigate to File > Add Package Dependencies... .

In the prompt that appears, search the following package URL:

https://github.com/googleads/googleads-mobile-ios-mediation-mintegral.git

В разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите main .

Используйте CocoaPods

Add the following line to your project's Podfile:
```
pod 'GoogleMobileAdsMediationMintegral'
```
В командной строке выполните:
```
pod install --repo-update
```

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

Download the latest version of the Mintegral SDK for iOS and link all the .framework files and bundles in your project.
Download the latest version of the Mintegral adapter from the download link in the Changelog and link MintegralAdapter.xcframework in your project.

Step 4: Implement privacy settings on Mintegral SDK

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

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

The Mintegral SDK includes the setConsentStatus method to pass consent information to the Mintegral SDK.

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

Быстрый

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

See Mintegral's privacy documentation for more information.

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

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

The Mintegral SDK includes setDoNotTrackStatus method to pass consent information to the Mintegral SDK.

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

Быстрый

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

See Mintegral's Privacy documentation for more information.

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

Интеграция SKAdNetwork

Follow Mintegral's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

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

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

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

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

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

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

Follow the steps in CCPA settings to add Mintegral to the CCPA ad partners list in the Ad Manager UI.

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

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

The Mintegral adapter returns its native ads as GADNativeAd objects. It populates the following fields for a GADNativeAd .

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

¹ The Mintegral adapter does not provide direct access to the main image asset for its native ads. Instead, the adapter populates the GADMediaView with a video or an image.

коды ошибок

If the adapter fails to receive an ad from Mintegral, you can check the underlying error from the ad response using GADResponseInfo.adNetworkInfoArray under the following classes:

GADMediationAdapterMintegral

Here are the codes and accompanying messages thrown by the Mintegral adapter when an ad fails to load:

Код ошибки	Домен	Причина
101	com.google.mediation.mintegral	Invalid server parameters (eg Missing app ID or placement ID).
102	com.google.mediation.mintegral	Mintegral SDK вернул ошибку "нет заполнения".
103	com.google.mediation.mintegral	Mintegral SDK не смог показать рекламу.
104	com.google.mediation.mintegral	The requested ad size does not match a Mintegral supported banner size.

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