AdSelectionConfig.Builder

public static final class AdSelectionConfig.Builder
extends Object

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionConfig.Builder

AdSelectionConfig 物件的建構工具。

摘要

公用建構函式

Builder()

公用方法

AdSelectionConfig build()

建構 AdSelectionConfig 例項。

AdSelectionConfig.Builder setAdSelectionSignals(AdSelectionSignals adSelectionSignals)

設定產生廣告選擇出價時提供給買方的信號。

AdSelectionConfig.Builder setCustomAudienceBuyers(List<AdTechIdentifier> customAudienceBuyers)

設定允許的買方清單。

AdSelectionConfig.Builder setDecisionLogicUri(Uri decisionLogicUri)

設定用來擷取決策邏輯的 URI，用於廣告選擇程序。

AdSelectionConfig.Builder setPerBuyerSignals(Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals)

設定每個買方在廣告選擇期間提供的信號。

AdSelectionConfig.Builder setSeller(AdTechIdentifier seller)

設定賣方 ID。

AdSelectionConfig.Builder setSellerSignals(AdSelectionSignals sellerSignals)

設定用來修改廣告選擇結果的信號。

AdSelectionConfig.Builder setTrustedScoringSignalsUri(Uri trustedScoringSignalsUri)

設定賣方受信任信號的 URI 端點，這個信號會從該信號接收廣告素材專屬即時資訊 系統會從中擷取哪些資訊

繼承方法

公用建構函式

Builder

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public Builder ()

公用方法

build

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig build ()

建構 AdSelectionConfig 例項。

傳回
AdSelectionConfig 此值不能為 null。
擲回
NullPointerException 如果有任何必要參數為空值

setAdSelectionSignals

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

設定產生廣告選擇出價時提供給買方的信號。

如未設定，預設為空白的 JSON。

詳情請參閱 AdSelectionConfig.getAdSelectionSignals()。

參數
adSelectionSignals AdSelectionSignals：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。

setCustomAudienceBuyers

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setCustomAudienceBuyers (List<AdTechIdentifier> customAudienceBuyers)

設定允許的買方清單。

詳情請參閱 AdSelectionConfig.getCustomAudienceBuyers()。

參數
customAudienceBuyers List：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。

setDecisionLogicUri

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

設定用來擷取決策邏輯的 URI，用於廣告選擇程序。審查結果 URI 可以是下列任一結構定義：

  • HTTPS：HTTPS URI 必須是主機與 seller 相符的絕對 URI
  • 預先建構的廣告選擇服務：廣告選擇服務 URI 會遵循 ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters> 格式。 FLEDGE 會產生適當的 JS 指令碼，無須使用網路呼叫。

    可用的預先建構指令碼：

    • scoreAds 和 reportResult 的 highest-bid-wins：這個 JS 選擇出價最高的廣告來進行評分。適用對象 報表時，指定 URI 會以 render_uri 和 bid 參數化。必須提供下列參數才能使用這個預先建構項目：
      • reportingUrl：基本報表 URI 稍後使用 render_uri 和 bid 參數化

      範例：如果基本報表網址為「https://www.ssp.com」然後ad-selection-prebuilt://ad-selection/highest-bid-wins/?reportingUrl=https://www.ssp.com

詳情請參閱 AdSelectionConfig.getDecisionLogicUri()。

參數
decisionLogicUri Uri：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。

setPerBuyerSignals

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setPerBuyerSignals (Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals)

設定每個買方在廣告選擇期間提供的信號。

如果未設定，預設為空白地圖。

詳情請參閱 AdSelectionConfig.getPerBuyerSignals()。

參數
perBuyerSignals Map：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。

setSeller

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

設定賣方 ID。

詳情請參閱 AdSelectionConfig.getSeller()。

參數
seller AdTechIdentifier：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。

setSellerSignals

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

設定用來修改廣告選擇結果的信號。

如未設定，預設為空白的 JSON。

詳情請參閱 AdSelectionConfig.getSellerSignals()。

參數
sellerSignals AdSelectionSignals：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。

setTrustedScoringSignalsUri

已加至 API 級別 34
也已納入 Ad Services Extensions 4 
public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

設定賣方受信任信號的 URI 端點，這個信號會從該信號接收廣告素材專屬即時資訊 系統會從中擷取哪些資訊

如果傳遞 Uri#EMPTY，系統會略過網路呼叫，並將 AdSelectionSignals.EMPTY 傳遞至廣告選擇。

詳情請參閱 AdSelectionConfig.getTrustedScoringSignalsUri()。

參數
trustedScoringSignalsUri Uri：此值不能為 null。
傳回
AdSelectionConfig.Builder 此值不能為 null。