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

Выберите платформу: 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 в запрос потока, вызвав метод streamRequest.setSecureSignals() :

app/src/main/java/com/example/project name/SampleAdsWrapper.java

 public void requestAndPlayAds() {
    adsLoader.addAdErrorListener(this);
    adsLoader.addAdsLoadedListener(this);
    StreamRequest request = buildStreamRequest();
    SecureSignals signal = SecureSignals.create("My encoded signal string");
    request.setSecureSignals(signal);
    request.setFormat(StreamFormat.HLS);
    adsLoader.requestStream(request);
  }