Эта страница переведена с помощью Cloud Translation API.

Интеграция PubMatic OpenWrap (бета-версия) с посредничеством

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

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

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

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

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

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

Требования

Android API уровня 23 или выше

Новейший Google Mobile Ads SDK .
Пройдите руководство по началу процесса медиации.

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

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

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

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

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

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

Under Integration Path , select Android (Java / Kotlin) and select AdMob - SDK Bidding as the Sub-integration Path . Then, click the Add App button.

Новая форма заявки

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

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

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

app-aps.txt

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

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

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

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

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

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

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

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

Форма создания рекламного блока

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Интеграция с Android Studio (рекомендуется)

В файле settings.gradle.kts на уровне проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://repo.pubmatic.com/artifactory/public-repos")
    }
  }
}

Затем в файле build.gradle.kts на уровне приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии SDK и адаптера PubMatic OpenWrap:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.1.0")
    implementation("com.google.ads.mediation:pubmatic:5.0.0.0")
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

коды ошибок

If the adapter fails to receive an ad from PubMatic, you can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following classes:

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

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

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

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