已加至 API 級別 34
也已納入 Ad Services Extensions 4

摘要： 對應者 |方法 |繼承方法

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 端點，這個信號會從該信號接收廣告素材專屬即時資訊 系統會從中擷取哪些資訊

繼承方法

來自類別： java.lang.Object Object clone() 建立並傳回此物件的副本。 boolean equals(Object obj) 指出是否有其他物件「等於」這個。 void finalize() 在垃圾收集作業時，垃圾收集器會呼叫該物件上的 判斷物件沒有其他參照 final Class<?> getClass() 傳回此 Object 的執行階段類別。 int hashCode() 傳回該物件的雜湊碼值。 final void notify() 喚醒目前等待這個物件的 監控功能 final void notifyAll() 喚醒所有等待此物件監控器的執行緒。 String toString() 傳回該物件的字串表示法。 final void wait(long timeoutMillis, int nanos) 讓目前的執行緒等待，直到遭到喚醒為止。 通知或中斷， 是否經過一定的即時效能 final void wait(long timeoutMillis) 讓目前的執行緒等待，直到遭到喚醒為止。 通知或中斷， 是否經過一定的即時效能 final void wait() 讓目前的執行緒等待，直到遭到喚醒為止。 通知或受到干擾。

公用建構函式

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。