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

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

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

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

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

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

^1. Интеграция каскадной модели находится на стадии альфа-тестирования.

^2. Все остальные поддерживаемые форматы рекламы, кроме баннеров, находятся в стадии альфа-тестирования.

Требования

• Целевая версия iOS для развертывания — 13.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 для Ad Manager .

Перед окончательным завершением разработки вашего приложения вам будут предложены соответствующие записи для добавления в app-ads.txt .

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

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

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

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

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

Заполните форму, указав данные вашего рекламного блока, и нажмите «Сохранить» .

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

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

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

Шаг 2: Настройте параметры PubMatic в пользовательском интерфейсе Ad Manager.

Войдите в свой аккаунт в Ad Manager .

Добавить PubMatic OpenWrap SDK в раздел «Компании»

Торги

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

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Выберите PubMatic OpenWrap SDK в качестве рекламной сети , введите уникальное имя и включите медиацию .

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

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

Торги

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Настройка системы торгов PubMatic OpenWrap SDK

Торги

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

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

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

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

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

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

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Создать новое сопоставление рекламных блоков» .

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

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

Важно: Нацеливайте рекламный блок на выбранный блок как минимум по одной группе доходности, а идентификатор издателя OpenWrap и идентификатор профиля OpenWrap должны быть связаны с целевым приложением, как это показано в пользовательском интерфейсе PubMatic OpenWrap SDK.

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» . Выберите ваше мобильное приложение .

Прокрутите вниз и нажмите «Добавить партнера по доходности» .

Выберите компанию, которую вы создали для PubMatic OpenWrap SDK в предыдущем разделе. В качестве типа интеграции выберите «Посредничество мобильного SDK» , в качестве платформы — «iOS» , а в качестве статуса — «Активный» .

Введите идентификатор рекламного блока OpenWrap, полученный в предыдущем разделе, и значение CPM по умолчанию . Нажмите «Сохранить» .

Важно: идентификатор издателя OpenWrap и идентификатор профиля OpenWrap должны быть связаны с целевым приложением, как это показано в пользовательском интерфейсе SDK PubMatic OpenWrap.

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

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

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

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

Примечание: Несоответствие версий PubMatic OpenWrap SDK и Google Mobile Ads SDK требованиям совместимости может привести к проблемам при сборке.

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

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

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

1. В Xcode перейдите в меню Файл > Добавить зависимости пакета... .

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 или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передано каждому источнику рекламы в вашей цепочке медиации.

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

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

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

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

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

Внедрить SKAdNetwork

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

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

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

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

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

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

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

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

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

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

Адаптер 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	SDK PubMatic вернул ошибку. Дополнительные сведения см. в документации PubMatic.

Список изменений адаптера медиации PubMatic для iOS

Версия 5.0.0.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 13.1.0.
• Версия SDK PubMatic OpenWrap: 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.
• Версия SDK PubMatic OpenWrap: 4.12.0.

Версия 4.11.0.2

• Обновлена ​​минимальная версия iOS для CocoaPods до 13.0 .

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 13.0.0.
• Версия SDK PubMatic OpenWrap: 4.11.0.

Версия 4.11.0.1

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.14.0.
• Версия SDK PubMatic OpenWrap: 4.11.0.

Версия 4.11.0.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.14.0.
• Версия SDK PubMatic OpenWrap: 4.11.0.

Версия 4.10.0.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.12.0.
• Версия SDK PubMatic OpenWrap: 4.10.0.

Версия 4.9.0.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.12.0.
• Версия SDK PubMatic OpenWrap: 4.9.0.

Версия 4.8.1.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.9.0.
• Версия SDK PubMatic OpenWrap: 4.8.1.

Версия 4.8.0.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.8.0.
• Версия SDK PubMatic OpenWrap: 4.8.0.

Версия 4.7.0.0

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

Разработано и протестировано с помощью:

• Версия Google Mobile Ads SDK: 12.6.0.
• Версия SDK PubMatic OpenWrap: 4.7.0.