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

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

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

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

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

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

1 Этот формат находится на этапе бета-тестирования. Чтобы получить доступ, обратитесь к менеджеру аккаунта.

Требования

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

  • Последняя версия Google Mobile Ads Unity Plugin.
  • Редактор Unity версии 2019.4 или более поздней.
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая версия iOS – 13.0 или более поздняя.
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads Unity Plugin. Подробная информация приведена в статье Как настроить Google Mobile Ads Unity Plugin.
  • Настройте медиацию.

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

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

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

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

Панель управления приложениями

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

Android

В разделе Путь интеграции выберите Unity, а в качестве дополнительного пути интеграции – AdMob – назначение ставок в SDK. Затем нажмите кнопку Добавить приложение.

Форма для нового приложения

iOS

В разделе Путь интеграции выберите Unity, а в качестве дополнительного пути интеграции – 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-aps.txt

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

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

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

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

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

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

Создание рекламного блока

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

Создание формы рекламного блока

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

Идентификатор рекламного блока приложения

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

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

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

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

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

Android

Инструкции приведены в разделе "Шаг 2" Android.

iOS

Инструкции приведены в разделе "Шаг 2" руководства для iOS.

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

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

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

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI, вы можете добавить в проект плагин медиации Google Mobile Ads PubMatic OpenWrap SDK для Unity, выполнив следующую команду в корневом каталоге проекта:

openupm add com.google.ads.mobile.mediation.pubmatic

OpenUPM

В редакторе проекта Unity выберите Edit (Правка) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов), чтобы открыть настройки менеджера пакетов Unity.

На вкладке Scoped Registries (Реестры с областью действия) добавьте OpenUPM в качестве реестра с областью действия, указав следующие сведения:

  • Название: OpenUPM
  • URL: https://package.openupm.com
  • Области действия: com.google

Подробности OpenUPM

Затем выберите Window (Окно) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager (Менеджер пакетов Unity), и в раскрывающемся меню выберите My Registries (Мои реестры).

Реестры Unity

Выберите пакет Google Mobile Ads PubMatic Mediation и нажмите Install (Установить).

Установка из OpenUPM

Пакет Unity

Скачайте последнюю версию плагина медиации Google Mobile Ads для PubMatic OpenWrap SDK по ссылке в журнале изменений и извлеките файл GoogleMobileAdsPubMaticMediation.unitypackage из ZIP-архива.

В редакторе проекта Unity выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Специальный пакет) и найдите скачанный файл GoogleMobileAdsPubMaticMediation.unitypackage. Убедитесь, что выбраны все файлы, и нажмите Импортировать.

Импорт из Unity

Затем выберите Assets (Ресурсы) > External Dependency Manager (Менеджер внешних зависимостей) > Android Resolver (Решатель Android) > Force Resolve (Принудительное разрешение). Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android приложения Unity.

Принудительное разрешение

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

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

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

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

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

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

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

Android

Для интеграции с PubMatic не требуется дополнительный код.

iOS

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

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

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

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

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

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

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

Коды ошибок

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

Android

com.pubmatic.sdk
com.google.ads.mediation.pubmatic

iOS

GADMediationAdapterPubMatic

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

Android

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

iOS

Код ошибки Поместье Причина
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 Не удалось загрузить один из источников изображений для нативного объявления.
107 com.google.ads.mediation.pubmatic В конфигурации объявления отсутствует идентификатор издателя.
108 com.google.ads.mediation.pubmatic В конфигурации рекламы отсутствует идентификатор профиля.
109 com.google.ads.mediation.pubmatic В конфигурации объявления указан идентификатор профиля, не являющийся числом.
110 com.google.ads.mediation.pubmatic В конфигурации объявления отсутствует идентификатор рекламного блока.
111 com.google.ads.mediation.pubmatic Не удалось создать экземпляр размера объявления в PubMatic OpenWrap SDK.
1001-5002 Отправлено с помощью PubMatic SDK SDK PubMatic вернул ошибку. Подробная информация приведена в документации PubMatic.

История изменений плагина PubMatic Unity Mediation

Версия 2.4.0

Версия 2.3.0

Версия 2.2.0

Версия 2.1.3

Версия 2.1.2

Версия 2.1.1

Версия 2.1.0

Версия 2.0.1

Версия 2.0.0

Версия 1.5.0

Версия 1.4.1

Версия 1.4.0

Версия 1.3.1

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.0