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

Интеграция PubMatic OpenWrap (бета-версия) с AdMob Mediation

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

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

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

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

^1. Интеграция каскадной модели находится на стадии альфа-тестирования.

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

Предварительные требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

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

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

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

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Выберите PubMatic OpenWrap SDK . Затем введите значение eCPM для PubMatic OpenWrap SDK и нажмите «Продолжить» .

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

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

Шаг 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.3.1")
    implementation("com.google.ads.mediation:pubmatic:5.2.0.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 или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передано каждому источнику рекламы в вашей цепочке медиации.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

коды ошибок

Если адаптер не получает объявление от 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.