開始使用安全信號

選取平台： HTML5 Android iOS tvOS

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

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

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

使用第三方信號供應商

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

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

Android 適用的 IMA SDK 會自動初始化每個安全信號轉接程式，您不需要對程式碼進行任何額外變更。

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

傳送自訂資料

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

針對每個廣告請求，請執行下列操作：

  1. 建立 SecureSignals 物件，其中包含編碼的自訂資料 (以字串形式)。
  2. 呼叫 adsRequest.setSecureSignals() 方法，將 SecureSignals 物件加入廣告請求：

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