Начните работу с безопасными сигналами

Выберите платформу: HTML5 Android iOS tvOS

Защищенные сигналы — это закодированные данные, которые собираются на устройстве клиента и передаются выбранным участникам торгов. В этом руководстве показано, как собирать и отправлять защищенные сигналы в Google Ad Manager с помощью IMA SDK.

Для работы API защищенных сигналов требуется версия 3.29.0 или выше IMA SDK для Android.

Чтобы выбрать сигналы и участников торгов, а также включить безопасный обмен сигналами, см. раздел «Обмен безопасными сигналами с участниками торгов» .

Используйте стороннего поставщика сигналов.

Для использования защищенных сигналов необходимо развернуть в приложении класс адаптера для сбора сигналов, который будет собирать сигналы, кодировать их и передавать в SDK IMA.

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

IMA SDK для Android автоматически инициализирует каждый адаптер защищенных сигналов без каких-либо дополнительных изменений в вашем коде.

Вот пример того, как можно добавить адаптер защищенных сигналов в свой проект:

Отправить пользовательские данные

Помимо использования стороннего поставщика сигналов, вы также можете собирать, кодировать и отправлять сигналы с пользовательскими данными. Прежде чем отправлять защищенные сигналы с пользовательскими данными, необходимо включить пользовательские сигналы в Ad Manager.

Для каждого запроса на показ рекламы выполните следующие действия:

  1. Создайте объект SecureSignals , содержащий закодированные пользовательские данные в виде строки.
  2. Добавьте объект SecureSignals в запрос на показ рекламы, вызвав метод adsRequest.setSecureSignals() :

private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
  SecureSignals signal = SecureSignals.create(secureSignalsString);
  adsRequest.setSecureSignals(signal);
}