Как интегрировать PubMatic с аукционами

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

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

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

¹ Интеграция каскада находится на альфа-стадии.

Требования

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

• Целевая версия iOS – 13.0 или более поздняя.

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

• Настройте медиацию.

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

Зарегистрируйтесь или войдите в аккаунт PubMatic и выберите карточку OpenWrap SDK.

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

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

Выберите платформу, а также URL приложения в магазине приложений и название приложения.

В разделе Путь интеграции выберите iOS (Objective-C / Swift), а в качестве дополнительного пути интеграции – AdMob – назначение ставок в SDK. Затем нажмите кнопку Добавить приложение.

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

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

Перед тем как приложение будет готово, вам будет предложено добавить в файл app-ads.txt необходимые записи.

Дополнительную информацию о том, как реализовать app-ads.txt для PubMatic, можно найти в статье Как реализовать файл app-ads.txt.

Идентификатор профиля

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

Создайте рекламный блок

На вкладке Рекламные блоки выберите приложение, созданное в предыдущем разделе, и нажмите кнопку Создать рекламный блок.

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

Запишите идентификатор рекламного блока OpenWrap.

Как получить идентификатор издателя

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

Шаг 2. Настройте источник спроса PubMatic в интерфейсе Менеджера рекламы

Войдите в аккаунт Менеджера рекламы.

Как добавить PubMatic OpenWrap SDK в раздел "Компании"

Как включить передачу защищенных сигналов

Как передавать защищенные сигналы в запросах ставок

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Как настроить назначение ставок в PubMatic OpenWrap SDK

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

Как добавить PubMatic в список рекламных партнеров для GDPR и законов штатов США

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

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

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

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

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

1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

2. В появившемся окне введите следующий URL пакета:

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

3. В разделе Правило зависимостей выберите Ветвь.

4. В текстовом поле введите main.

Через CocoaPods

• Добавьте в Podfile проекта следующую строку:

  pod 'GoogleMobileAdsMediationPubMatic'
  

• В командной строке выполните следующую команду:

  pod install --repo-update

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

1. Скачайте последнюю версию PubMatic OpenWrap SDK для iOS и свяжите все файлы и пакеты .xcframework в своем проекте.

2. Скачайте последнюю версию адаптера PubMatic по ссылке в журнале изменений и добавьте ссылку PubMaticAdapter.xcframework в свой проект.

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

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

PubMatic автоматически считывает согласие по GDPR, заданное платформами для запросов согласия, которые поддерживают спецификацию Google "Дополнительное согласие", в том числе UMP SDK. Подробнее о том, как передавать согласие по GDPR…

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

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

PubMatic автоматически считывает согласие, заданное в GPP платформами для запросов согласия, которые поддерживают спецификацию Google "Дополнительное согласие", в том числе UMP SDK. Подробнее о том, как передавать согласие в рамках GPP…

Шаг 5. Добавьте обязательный код

Как реализовать SKAdNetwork

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

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

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

Зарегистрируйте тестовое устройство в Менеджере рекламы.

Как проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления из PubMatic OpenWrap SDK, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источник объявлений PubMatic OpenWrap.

Необязательные шаги

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

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

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

Коды ошибок

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

GADMediationAdapterPubMatic

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

Журнал изменений адаптера медиации PubMatic для iOS

Версия 5.4.1.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.4.1.

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

• Google Mobile Ads SDK версии 13.10.0.
• PubMatic OpenWrap SDK версии 5.4.1.

Версия 5.4.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.4.0.

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

• Google Mobile Ads SDK версии 13.9.0.
• PubMatic OpenWrap SDK версии 5.4.0.

Версия 5.3.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.3.0.

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

• Google Mobile Ads SDK версии 13.8.0.
• PubMatic OpenWrap SDK версии 5.3.0.

Версия 5.2.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.2.0.
• Теперь требуется Google Mobile Ads SDK версии 13.6 или более поздней.
• Добавлена поддержка видеообъектов в нативных объявлениях с использованием API mediaView.

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

• Google Mobile Ads SDK версии 13.7.0.
• PubMatic OpenWrap SDK версии 5.2.0.

Версия 5.1.1.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.1.1.

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

• Google Mobile Ads SDK версии 13.4.0.
• PubMatic OpenWrap SDK версии 5.1.1.

Версия 5.1.0.1

• Теперь адаптер пересылает флаг ageRestrictedTreatment Google Mobile Ads SDK в COPPA API PutMatic OpenWrap SDK.

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

• Google Mobile Ads SDK версии 13.3.0.
• PubMatic OpenWrap SDK версии 5.1.0.

Версия 5.1.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.1.0.

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

• Google Mobile Ads SDK версии 13.3.0.
• PubMatic OpenWrap SDK версии 5.1.0.

Версия 5.0.1.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.0.1.

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

• Google Mobile Ads SDK версии 13.2.0.
• PubMatic OpenWrap SDK версии 5.0.1.

Версия 5.0.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 5.0.0.

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

• Google Mobile Ads SDK версии 13.1.0.
• PubMatic OpenWrap SDK версии 5.0.0.

Версия 4.12.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.12.0.
• Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

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

• Google Mobile Ads SDK версии 13.0.0.
• PubMatic OpenWrap SDK версии 4.12.0.

Версия 4.11.0.2

• Минимальная версия iOS для CocoaPods теперь 13.0.

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

• Google Mobile Ads SDK версии 13.0.0.
• PubMatic OpenWrap SDK версии 4.11.0.

Версия 4.11.0.1

• Добавлена поддержка пересылки параметров tagForChildDirectedTreatment и tagForUnderAgeOfConsent Google Mobile Ads SDK в PubMatic OpenWrap SDK.

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

• Google Mobile Ads SDK версии 12.14.0.
• PubMatic OpenWrap SDK версии 4.11.0.

Версия 4.11.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.11.0.

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

• Google Mobile Ads SDK версии 12.14.0.
• PubMatic OpenWrap SDK версии 4.11.0.

Версия 4.10.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.10.0.

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

• Google Mobile Ads SDK версии 12.12.0.
• PubMatic OpenWrap SDK версии 4.10.0.

Версия 4.9.0.0

• Добавлена поддержка каскада для баннеров, межстраничных и нативных объявлений, а также объявлений с вознаграждением.
• Исправлена ошибка, из-за которой делегаты нативных объявлений задавались неправильно.
• Добавьте свойство тестового режима в класс GADMediationAdapterPubMaticExtras.
• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.9.0.

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

• Google Mobile Ads SDK версии 12.12.0.
• PubMatic OpenWrap SDK версии 4.9.0.

Версия 4.8.1.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.8.1.

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

• Google Mobile Ads SDK версии 12.9.0.
• PubMatic OpenWrap SDK версии 4.8.1.

Версия 4.8.0.0

• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.8.0.

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

• Google Mobile Ads SDK версии 12.8.0.
• PubMatic OpenWrap SDK версии 4.8.0.

Версия 4.7.0.0

• Первый выпуск.
• Поддерживается назначение ставок для баннеров, межстраничных, нативных объявлений и объявлений с вознаграждением.
• Подтверждена совместимость с PubMatic OpenWrap SDK версии 4.7.0.

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

• Google Mobile Ads SDK версии 12.6.0.
• PubMatic OpenWrap SDK версии 4.7.0.