Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать Mintegral с медиацией

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

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

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

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

Интеграция
Ставки
Водопад
Форматы
Открытие приложения
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением
Стандартное

Требования

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

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

Последняя версия Google Mobile Ads SDK.
Настройте медиацию AdMob.

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

Зарегистрируйтесь или войдите в аккаунт Mintegral.

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

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

Как добавить новое приложение

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

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

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

Как создать место размещения объявлений

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

Укажите название места размещения и формат объявления.

Ставки

В качестве типа назначения ставок выберите Назначение ставок в заголовке. Заполните остальные поля формы и нажмите Сохранить.

Водопад

В качестве типа назначения ставок выберите Каскад. Заполните остальные поля формы и нажмите Сохранить.

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

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

Как найти ключ API отчетности Mintegral

Ставки

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

Водопад

Чтобы настроить идентификатор рекламного блока AdMob, вам понадобится ключ API для отчетов Mintegral. Выберите Аккаунт > Инструменты API. Запишите значения Skey и Secret.

Как обновить файл app-ads.txt

Authorized Sellers for Apps (Авторизованные продавцы приложений), или app-ads.txt, – это инициатива IAB Tech Lab, которая позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, настройте файл app-ads.txt для приложения.

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

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

Как настроить медиацию для рекламного блока

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

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

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

Укажите формат и платформу объявления и нажмите Продолжить.

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить Mintegral в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и нажмите Добавить источник объявлений. Затем выберите Mintegral.

Нажмите Как подписать партнерское соглашение и настройте партнерство по назначению ставок с Mintegral.

Нажмите Подтвердить и принять, а затем – Продолжить.

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

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

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

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

Как добавить Mobvista/Mintegral в список рекламных партнеров для соблюдения GDPR и законов штатов США в отношении конфиденциальности

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

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

Как использовать Swift Package Manager

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

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

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне введите следующий URL пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-mintegral.git
```
В разделе Правило зависимостей выберите Ветвь.
В текстовом поле введите main.

Через CocoaPods

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

Настраиваемые вручную интеграции

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

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

Согласие пользователей из ЕС и GDPR

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

Адаптер Mintegral для iOS версии 7.7.9.0 и более поздних поддерживает передачу сигналов согласия по GDPR из платформ для запросов согласия, интегрированных со спецификацией Transparency and Consent Framework (TCF) от IAB, в Mintegral SDK. Подробнее о заявлении о соответствии SDK требованиям конфиденциальности…

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

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

В Mintegral SDK есть метод setDoNotTrackStatus, который позволяет передавать информацию о согласии в Mintegral SDK.

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

Swift

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 (аукцион) и Mintegral (каскад).

Необязательные действия

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

Чтобы добавить Mintegral в список рекламных партнеров, соблюдающих закон штата Калифорния "О праве на конфиденциальность" (CCPA), в интерфейсе AdMob, выполните инструкции из раздела Настройки CCPA.

Нативные объявления

Отображение объявлений

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

Поле	Объекты, которые всегда включает адаптер Mintegral
Заголовок
Изображение	1
Body
Значок
Призыв к действию
Star rating
Магазин
Цена
Рекламодатель

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

Коды ошибок

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

GADMediationAdapterMintegral

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

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