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

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

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

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

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

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

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

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

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

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

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

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

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

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

app/src/main/java/com/example/имя проекта/MainActivity.java

...
private void requestAds(String adTagUrl) {
  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(adTagUrl);
  request.setContentProgressProvider(
      () -> {
        if (videoPlayer.getDuration() <= 0) {
          return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
        }
        return new VideoProgressUpdate(
            videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
      });
  
  SecureSignals signal = SecureSignals.create("My encoded signal string");
  request.setSecureSignals(signal);
  
  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}
...