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<AdTechIdentifierAdSelectionSignals> 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 指令碼,無須使用網路呼叫。

    可用的預先建構指令碼:

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

      範例:如果基本報表網址為「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<AdTechIdentifierAdSelectionSignals> 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