Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

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

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

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

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

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

Требования

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

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

Последняя версия Google Mobile Ads SDK.
Настройте медиацию AdMob.

Шаг 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-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте источник спроса PubMatic в интерфейсе AdMob

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

Вам нужно добавить PubMatic OpenWrap SDK в конфигурацию медиации для рекламного блока.

Войдите в аккаунт AdMob. Затем перейдите на вкладку Медиация. Если у вас уже есть группа медиации, которую вы хотите изменить, нажмите на ее название и перейдите к разделу Как добавить SDK PubMatic OpenWrap в качестве источника объявлений.

Чтобы создать новую группу медиации, нажмите Создать группу медиации.

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

Укажите название группы медиации и выберите целевые местоположения. Затем установите для группы медиации статус Включено и нажмите Добавить рекламные блоки.

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово.

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить PubMatic OpenWrap SDK в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и нажмите Добавить источник объявлений. Затем выберите PubMatic OpenWrap SDK.

Нажмите Подтвердить и принять, а затем Сохранить.

Если у вас уже есть сопоставление для PubMatic OpenWrap SDK, выберите его. В противном случае нажмите Добавить сопоставление.

Затем введите идентификатор рекламного блока OpenWrap, полученный в предыдущем разделе. Затем нажмите Готово.

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

Выберите PubMatic OpenWrap SDK. Затем введите эффективную цену за тысячу показов для SDK PubMatic OpenWrap и нажмите Продолжить.

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

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

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

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

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

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

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне введите следующий URL пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-pubmatic.git
```
В разделе Правило зависимостей выберите Ветвь.
В текстовом поле введите main.

Через CocoaPods

Добавьте в Podfile проекта следующую строку:
```
pod 'GoogleMobileAdsMediationPubMatic'
```
В командной строке выполните следующую команду:
```
pod install --repo-update
```

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

Скачайте последнюю версию PubMatic OpenWrap SDK для iOS и свяжите все файлы и пакеты .xcframework в своем проекте.
Скачайте последнюю версию адаптера 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. Проверьте реализацию

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

Зарегистрируйте тестовое устройство в AdMob.

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

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

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

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

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

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

Поле	Объекты, всегда включаемые адаптером PubMatic
Заголовок
Изображение
Body
Значок
Призыв к действию
Star rating
Магазин
Цена
Рекламодатель

Коды ошибок

Если адаптер не может получить объявление от 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	Не удалось загрузить один из источников изображений для нативного объявления.
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.