Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

Интеграция PubMatic с посредничеством

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK.
Завершите руководство по началу работы с посредничеством.

Шаг 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 для своего приложения .

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

app-aps.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройте параметры медиации для вашего рекламного блока

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

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

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

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

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

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

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавить PubMatic OpenWrap SDK в качестве источника рекламы

В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите PubMatic OpenWrap SDK .

Нажмите «Как подписать партнерское соглашение» и настроить партнерство по торгам с помощью PubMatic OpenWrap SDK.

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Рендеринг рекламы

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

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

Коды ошибок

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

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