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

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

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

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

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

^1. Интеграция системы назначения ставок находится в закрытой бета-версии. Для получения доступа свяжитесь со своим менеджером по работе с клиентами.

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

Требования

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

• Новейшая версия SDK для мобильной рекламы от Google.

• Пройдите руководство по началу процесса медиации.

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

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

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

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

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

В разделе «Путь интеграции» выберите Android (Java/Kotlin) и укажите 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 .

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

Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи 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:24.9.0")
    implementation("com.google.ads.mediation:pubmatic:4.10.0.1")
}

Шаг 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, вы можете проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdapterResponses() из следующих классов:

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

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

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

Версия 4.10.0.1

• Добавлен список ресурсов для нативного рекламного формата "водопад".

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

• Версия Google Mobile Ads SDK: 24.7.0.
• Версия SDK Pubmatic: 4.10.0

Версия 4.10.0.0

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

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

• Версия Google Mobile Ads SDK: 24.7.0.
• Версия SDK Pubmatic: 4.10.0

Версия 4.9.1.0

• Подтверждена совместимость с Pubmatic SDK 4.9.1.

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

• Версия Google Mobile Ads SDK: 24.6.0.
• Версия SDK Pubmatic: 4.9.1

Версия 4.8.0.1

• Добавлена ​​поддержка всплывающих рекламных объявлений типа «водопад».
• Добавлена ​​поддержка рекламы с вознаграждением по принципу водопада.
• Добавлена ​​поддержка баннерной рекламы в виде водопада.
• Добавлена ​​поддержка нативной рекламы в водопадной модели.
• Подтверждена совместимость с Pubmatic SDK 4.8.0.

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

• Версия Google Mobile Ads SDK: 24.6.0.
• Версия SDK Pubmatic: 4.8.0

Версия 4.8.0.0

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

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

• Версия Google Mobile Ads SDK: 24.4.0.
• Версия SDK Pubmatic 4.8.0.

Версия 4.7.1.1

• Исправлен размер значка AdChoices

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

• Версия Google Mobile Ads SDK: 24.4.0.
• Версия SDK Pubmatic 4.7.1.

Версия 4.7.1.0

• Подтверждена совместимость с Pubmatic SDK 4.7.1.

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

• Версия Google Mobile Ads SDK: 24.4.0.
• Версия SDK Pubmatic 4.7.1.

Версия 4.7.0.1

• Исправлены внутренние зависимости.

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

• Версия Google Mobile Ads SDK: 24.4.0.
• Версия SDK Pubmatic 4.7.0.

Версия 4.7.0.0

• Первый релиз.
• Добавлена ​​поддержка назначения ставок для баннерной, межстраничной, рекламной и нативной рекламы.
• Подтверждена совместимость с Pubmatic SDK 4.7.0.

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

• Версия Google Mobile Ads SDK: 24.4.0.
• Версия SDK Pubmatic 4.7.0.