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

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

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

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

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

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

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

Требования

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

Android API уровня 24 или более поздней версии.

Последняя версия GMA Next-Gen SDK.
Настройте медиацию AdMob.

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

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

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

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

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

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

В разделе Путь интеграции выберите Android (Java / Kotlin), а в качестве дополнительного пути интеграции – 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 и адаптер

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:pubmatic:5.4.1.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

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

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

Код ошибки	Поместье	Причина
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.