安全信號

安全信號是經過編碼的資料，會在用戶端裝置上收集，並與特定出價方共用。本指南將說明如何使用 IMA SDK 收集安全信號，並傳送至 Google Ad Manager。

安全信號 API 需要 Android 版 IMA SDK 3.29.0 以上版本。

如要選取信號和出價方，並啟用安全信號共用功能，請參閱「與出價方共用安全信號」。

使用第三方信號供應器

如要使用安全信號，您必須在應用程式中部署信號收集器轉接器類別，以便收集信號、對信號進行編碼，並將信號傳遞至 IMA SDK。

請按照第三方供應商的操作說明設定帳戶，新增建構依附元件，並在應用程式中設定安全信號轉接器。

Android 版 IMA SDK 會自動初始化每個安全信號轉接程式，無須額外變更程式碼。

以下範例說明如何在專案中加入安全信號轉接程式：

傳送自訂資料

注意： 含有自訂資料的安全信號為 Beta 版功能，可能未開放給您的聯播網使用。請與客戶經理聯絡，要求使用這項功能。

除了使用第三方信號供應器，您也可以收集、編碼及傳送含有自訂資料的信號。您必須先在 Ad Manager 中啟用自訂信號，才能傳送含有自訂資料的安全信號。

針對每項廣告請求，建立包含已編碼自訂資料的 SecureSignals 物件，做為字串。然後，呼叫 adsRequest.setSecureSignals() 將 SecureSignals 物件加入廣告請求中。

以下是 Java 範例：

app/src/main/java/com/example/project name/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);
}
...