Интегрируйте PubMatic с назначением ставок

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

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

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

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

Требования

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

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

• Завершите руководство по началу работы с посредничеством.

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

Войдите в свою учетную запись PubMatic и выберите карту OpenWrap SDK .

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

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

Выберите платформу , а также URL-адрес App Store и название приложения для вашего приложения.

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

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

Файл 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 в пользовательском интерфейсе Менеджера рекламы

Войдите в свою учетную запись Менеджера рекламы .

Включить безопасный обмен сигналами

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

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

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите PubMatic и включите опцию «Включить интеграцию приложений» .

Нажмите «Сохранить» .

Разрешить безопасный обмен сигналами для SDK Bidding

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Настройте ставки PubMatic

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите PubMatic в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

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

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для PubMatic OpenWrap SDK.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Выберите конкретный рекламный блок . Выберите рекламный блок и формат, выберите «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите идентификатор рекламного блока OpenWrap, полученный в предыдущем разделе.

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

Наконец, нажмите кнопку Сохранить .

Важно: настройте таргетинг выбранного рекламного блока как минимум на одну группу доходности.

Добавьте PubMatic в список рекламных партнеров, соответствующих GDPR и государственным нормам США.

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

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

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

Примечание: отсутствие интеграции совместимых версий PubMatic и Google Mobile Ads SDK может привести к проблемам при сборке.

CocoaPods (рекомендуется)

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

  pod 'GoogleMobileAdsMediationPubMatic'
  

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

  pod install --repo-update

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

1. Загрузите последнюю версию PubMatic OpenWrap SDK для iOS и свяжите все файлы и пакеты .xcframework в вашем проекте.

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

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

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

PubMatic автоматически считывает согласие GDPR, установленное платформами управления согласием, поддерживающими спецификацию дополнительного согласия Google , включая UMP SDK . Подробнее см. в разделах «Передача GDPR» и «Согласие GDPR» .

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

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

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

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

Интеграция SKAdNetwork

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

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

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

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

Важно: отключите тестовый режим для Ad Manager и PubMatic OpenWrap SDK перед выпуском приложения.

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

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

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

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

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

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

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

Коды ошибок

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

GADMediationAdapterPubMatic

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

Код ошибки	Домен	Причина
101	com.google.ads.mediation.pubmatic	В конфигурации сервера отсутствует требуемый идентификатор издателя.
102	com.google.ads.mediation.pubmatic	Запрос на сбор сигналов торгов не выполнен, поскольку в параметрах запроса указано несколько форматов, не указано ни одного формата или указан неподдерживаемый формат.
103	com.google.ads.mediation.pubmatic	Недопустимая конфигурация объявления для загрузки.
104	com.google.ads.mediation.pubmatic	Не удалось показать рекламное объявление, так как оно не было готово.
105	com.google.ads.mediation.pubmatic	Не удалось показать объявление с вознаграждением, так как оно не было готово.
106	com.google.ads.mediation.pubmatic	Не удалось загрузить один из источников собственных рекламных изображений.
1001-5002	Отправлено PubMatic SDK	PubMatic SDK вернул ошибку. Подробнее см. в документации PubMatic.

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

Версия 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.