To discuss and provide feedback on our products, join the official AdMob Discord channel in the Google Advertising and Measurement Community server.

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

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

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

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

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

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

Требования

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

Последняя версия 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 и адаптер

Использование CocoaPods (рекомендуется)

Добавьте следующую строку в Podfile вашего проекта:
```
pod 'GoogleMobileAdsMediationMintegral'
```
В командной строке выполните:
```
pod install --repo-update
```

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

Загрузите последнюю версию Mintegral SDK для iOS и свяжите все файлы и пакеты .framework в вашем проекте.
Загрузите последнюю версию адаптера Mintegral по ссылке в журнале изменений и добавьте MintegralAdapter.xcframework в свой проект.

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

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

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

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

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

Быстрый

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C

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

[[MTGSDK sharedInstance] setConsentStatus:YES];

Более подробную информацию см. в документации по конфиденциальности Mintegral .

Законы США о конфиденциальности

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

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

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

Быстрый

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C

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

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

Более подробную информацию см. в документации по конфиденциальности Mintegral .

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

Интеграция SKAdNetwork

Следуйте документации Mintegral , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

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

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

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

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

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

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

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

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

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

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

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

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

¹ Адаптер Mintegral не предоставляет прямого доступа к основному изображению для нативной рекламы. Вместо этого адаптер заполняет GADMediaView видео или изображением.

Коды ошибок

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

GADMediationAdapterMintegral

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

Код ошибки	Домен	Причина
101	com.google.mediation.mintegral	Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор размещения).
102	com.google.mediation.mintegral	Mintegral SDK вернул ошибку отсутствия заполнения.
103	com.google.mediation.mintegral	Mintegral SDK не смог отобразить рекламу.
104	com.google.mediation.mintegral	Запрошенный размер объявления не соответствует поддерживаемому Mintegral размеру баннера.