Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

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

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

Android iOS Unity Flutter

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

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

Обновите файл app-ads.txt.

Файл 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 . Затем введите значение eCPM для Mintegral и нажмите «Продолжить» .

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

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

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

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

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

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

В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий 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: Внедрите настройки конфиденциальности в SDK Mintegral.

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

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

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

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

Быстрый

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C

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

[[MTGSDK sharedInstance] setConsentStatus:YES];

Для получения более подробной информации ознакомьтесь с документацией Mintegral по вопросам конфиденциальности .

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

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

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

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

Быстрый

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C

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

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

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

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

Интеграция SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

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

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

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

^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.