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

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

Поддерживаемые интеграции и форматы объявлений

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

Интеграция
Торги
Водопад
Форматы
Приложение открыто	^1
Баннер
Межстраничный
Награжден
Межстраничное объявление с вознаграждением
Родной	^2

¹ Интеграция ставок и водопада для формата открытой рекламы в приложении находится на стадии закрытого бета-тестирования.

² Интеграция ставок и водопада для нативного формата объявлений находится на стадии открытого бета-тестирования.

Требования

• Цель развертывания iOS 11.0 или выше

• Последняя версия Google Mobile Ads SDK

• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

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

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

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

Важно! Для формата нативного объявления выберите «Нативный (настраиваемый рендеринг)» в качестве формата AD .

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

Торги

В карточке «Ставки» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите Mintegral.
Нажмите Как подписать партнерское соглашение и организовать тендерное партнерство с «Минтеграл».
Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .
Если у вас уже есть сопоставление для Mintegral, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .
Затем введите ключ приложения , идентификатор приложения , идентификатор места размещения и идентификатор рекламного блока , полученные в предыдущем разделе. Затем нажмите Готово . Важно ! Идентификатор приложения и ключ приложения должны быть связаны с целевым приложением, как в пользовательском интерфейсе Mintegral.

Водопад

Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите Mintegral .

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

Примечание . Оптимизацию источника объявлений необходимо настроить только один раз для каждой сети.

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

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

Важно ! Идентификатор приложения и ключ приложения должны быть связаны с целевым приложением, как в пользовательском интерфейсе Mintegral.

Добавлять Mintegral в соответствии с GDPR и списком рекламных партнеров США.

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

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

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

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

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

• Добавьте следующую строку в подфайл вашего проекта:

  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)

Цель-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)

Цель-C

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

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

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

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

Интеграция со SKAdNetwork

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

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

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

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

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

Важно: отключите тестовый режим для AdMob и Mintegral перед выпуском приложения.

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

Чтобы убедиться, что вы получаете тестовые объявления от Mintegral, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Mintegral (Biddding) и 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.

Журнал изменений адаптера-посредника Mintegral iOS

Версия 7.7.3.0

• Проверена совместимость с Mintegral SDK версии 7.7.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.10.0.
• Mintegral SDK версии 7.7.3.

Версия 7.7.2.1

• Адаптер больше не проверяет готовность межстраничных объявлений и объявлений с вознаграждением перед их показом.
• Обновлен CFBundleShortVersionString , чтобы иметь три компонента вместо четырех.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.10.0.
• Mintegral SDK версии 7.7.2.

Версия 7.7.2.0

• Проверенная совместимость с Mintegral SDK версии 7.7.2.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.9.0.
• Mintegral SDK версии 7.7.2.

Версия 7.7.1.0

• Проверенная совместимость с Mintegral SDK версии 7.7.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.8.0.
• Mintegral SDK версии 7.7.1.

Версия 7.7.0.0

• Проверенная совместимость с Mintegral SDK версии 7.7.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.8.0.
• Mintegral SDK версии 7.7.0.

Версия 7.6.9.0

• Проверенная совместимость с Mintegral SDK версии 7.6.9.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.7.0.
• Mintegral SDK версии 7.6.9.

Версия 7.6.8.0

• Проверена совместимость с Mintegral SDK версии 7.6.8.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.7.0.
• Mintegral SDK версии 7.6.8.

Версия 7.6.7.0

• Проверена совместимость с Mintegral SDK версии 7.6.7.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.6.0.
• Mintegral SDK версии 7.6.7.

Версия 7.6.6.0

• Проверенная совместимость с Mintegral SDK версии 7.6.6.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.5.0.
• Mintegral SDK версии 7.6.6.

Версия 7.6.4.0

• Проверенная совместимость с Mintegral SDK версии 7.6.4.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.4.0.
• Mintegral SDK версии 7.6.4.

Версия 7.6.3.0

• Проверена совместимость с Mintegral SDK версии 7.6.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.3.0.
• Mintegral SDK версии 7.6.3.

Версия 7.6.2.0

• Проверена совместимость с Mintegral SDK версии 7.6.2.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.3.0.
• Mintegral SDK версии 7.6.2.

Версия 7.6.1.0

• Проверена совместимость с Mintegral SDK версии 7.6.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.3.0.
• Mintegral SDK версии 7.6.1.

Версия 7.6.0.0

• Проверена совместимость с Mintegral SDK версии 7.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.2.0.
• Mintegral SDK версии 7.6.0.

Версия 7.5.9.0

• Проверена совместимость с Mintegral SDK версии 7.5.9.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.2.0.
• Mintegral SDK версии 7.5.9.

Версия 7.5.8.0

• Проверена совместимость с Mintegral SDK версии 7.5.8.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.1.0.
• Mintegral SDK версии 7.5.8.

Версия 7.5.7.0

• Проверена совместимость с Mintegral SDK версии 7.5.7.
• Теперь требуется минимальная версия iOS 12.0.
• Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
• Info.plist включен в рамки MintegralAdapter.xcframework .

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.0.1.
• Mintegral SDK версии 7.5.7.

Версия 7.5.6.0

• Проверена совместимость с Mintegral SDK версии 7.5.6.
• Сделал GADMediationAdapterMintegral.h общедоступным заголовком.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 11.0.0.
• Mintegral SDK версии 7.5.6.

Версия 7.5.3.0

• Проверенная совместимость с Mintegral SDK версии 7.5.3.
• Добавлена ​​поддержка ставок для формата объявлений при открытии приложения.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.14.0.
• Mintegral SDK версии 7.5.3.

Версия 7.4.8.0

• Проверенная совместимость с Mintegral SDK версии 7.4.8.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.13.0.
• Mintegral SDK версии 7.4.8.

Версия 7.4.7.0

• Обновлен файл podspec, чтобы он зависел от MintegralAdSDK/All вместо MintegralAdSDK .
• Проверена совместимость с Mintegral SDK версии 7.4.7.
• Добавлена ​​поддержка водопада для формата объявления при открытии приложения.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.12.0.
• Mintegral SDK версии 7.4.7.

Версия 7.4.4.0

• Добавлена ​​поддержка водяных знаков для объявлений с назначением ставок.
• Проверена совместимость с Mintegral SDK версии 7.4.4.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.10.0.
• Mintegral SDK версии 7.4.4.

Версия 7.4.3.0

• Проверена совместимость с Mintegral SDK версии 7.4.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.9.0.
• Mintegral SDK версии 7.4.3.

Версия 7.4.1.0

• Проверенная совместимость с Mintegral SDK версии 7.4.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.7.0.
• Mintegral SDK версии 7.4.1.

Версия 7.3.9.0

• Проверена совместимость с Mintegral SDK версии 7.3.9.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.7.0.
• Mintegral SDK версии 7.3.9.

Версия 7.3.8.0

• Проверенная совместимость с Mintegral SDK версии 7.3.8.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.6.0.
• Mintegral SDK версии 7.3.8.

Версия 7.3.7.0

• Проверена совместимость с Mintegral SDK версии 7.3.7.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.5.0.
• Mintegral SDK версии 7.3.7.

Версия 7.3.6.0

• Проверенная совместимость с Mintegral SDK версии 7.3.6.
• Удалена поддержка архитектуры armv7 .
• Теперь требуется минимальная версия iOS 11.0.
• Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.5.0.
• Mintegral SDK версии 7.3.6.

Версия 7.3.4.0

• Проверенная совместимость с Mintegral SDK версии 7.3.4.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.2.0.
• Mintegral SDK версии 7.3.4.

Версия 7.3.3.0

• Проверенная совместимость с Mintegral SDK версии 7.3.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.2.0.
• Mintegral SDK версии 7.3.3.

Версия 7.3.0.0

• Проверенная совместимость с Mintegral SDK версии 7.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.1.0.
• Mintegral SDK версии 7.3.0.

Версия 7.2.9.1

• Добавлена ​​каскадная поддержка форматов баннеров (включая MREC), межстраничных объявлений, объявлений с вознаграждением и нативной рекламы.
• Требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 10.0.0.
• Mintegral SDK версии 7.2.9.

Версия 7.2.9.0

• Проверена совместимость с Mintegral SDK версии 7.2.9.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 9.14.0.
• Mintegral SDK версии 7.2.9.

Версия 7.2.8.0

• Проверенная совместимость с Mintegral SDK версии 7.2.8.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 9.14.0.
• Mintegral SDK версии 7.2.8.

Версия 7.2.6.0

• Первый выпуск!
• Добавлена ​​поддержка ставок для форматов баннеров (включая MREC), межстраничных объявлений, объявлений с вознаграждением и нативных объявлений.
• Проверенная совместимость с Mintegral SDK версии 7.2.6.
• Требуется Google Mobile Ads SDK версии 9.8.0 или выше.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 9.13.0.
• Mintegral SDK версии 7.2.6.