Защищенные сигналы — это закодированные данные, которые собираются на устройстве клиента и передаются выбранным участникам торгов. В этом руководстве показано, как собирать и отправлять защищенные сигналы в Google Ad Manager с помощью IMA SDK.
Для работы API защищенных сигналов требуется версия 3.29.0 или выше IMA SDK для Android.
Чтобы выбрать сигналы и участников торгов, а также включить безопасный обмен сигналами, см. раздел «Обмен безопасными сигналами с участниками торгов» .
Используйте стороннего поставщика сигналов.
Для использования защищенных сигналов необходимо развернуть в приложении класс адаптера для сбора сигналов, который будет собирать сигналы, кодировать их и передавать в SDK IMA.
Следуйте инструкциям стороннего поставщика, чтобы создать у него учетную запись, добавить зависимости для сборки и настроить адаптер защищенных сигналов в вашем приложении.
IMA SDK для Android автоматически инициализирует каждый адаптер защищенных сигналов без каких-либо дополнительных изменений в вашем коде.
Вот пример того, как можно добавить адаптер защищенных сигналов в свой проект:

Отправить пользовательские данные
Помимо использования стороннего поставщика сигналов, вы также можете собирать, кодировать и отправлять сигналы с пользовательскими данными. Прежде чем отправлять защищенные сигналы с пользовательскими данными, необходимо включить пользовательские сигналы в Ad Manager.
Для каждого запроса на показ рекламы выполните следующие действия:
- Создайте объект
SecureSignals, содержащий закодированные пользовательские данные в виде строки. - Добавьте объект
SecureSignalsв запрос на показ рекламы, вызвав методadsRequest.setSecureSignals():
private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
SecureSignals signal = SecureSignals.create(secureSignalsString);
adsRequest.setSecureSignals(signal);
}