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

摘要：建構函式 | 方法 | 沿用的方法

CustomAudience.Builder

public static final class CustomAudience.Builder
extends Object

java.lang.Object
↳	android.adservices.customaudience.CustomAudience.Builder

---

CustomAudience 物件的建構工具。

摘要

公用建構函式
Builder()

公用方法
CustomAudience	build() 建構 CustomAudience 的執行個體。
CustomAudience.Builder	setActivationTime(Instant activationTime) 設定時間 (截斷至毫秒)，之後 CustomAudience 就會放送廣告。
CustomAudience.Builder	setAds(List<AdData> ads) 設定自訂目標對象放送的初始再行銷廣告。
CustomAudience.Builder	setBiddingLogicUri(Uri biddingLogicUri) 設定要擷取出價邏輯的 URI，以便在廣告選擇程序中使用。
CustomAudience.Builder	setBuyer(AdTechIdentifier buyer) 設定買家 AdTechIdentifier。
CustomAudience.Builder	setDailyUpdateUri(Uri dailyUpdateUri) 設定每日更新 URI。
CustomAudience.Builder	setExpirationTime(Instant expirationTime) 設定時間 (縮短至毫秒)，之後應移除 CustomAudience。
CustomAudience.Builder	setName(String name) 設定 CustomAudience 物件的名稱。
CustomAudience.Builder	setTrustedBiddingData(TrustedBiddingData trustedBiddingData) 設定要查詢且用於廣告選擇程序的受信任出價資料。
CustomAudience.Builder	setUserBiddingSignals(AdSelectionSignals userBiddingSignals) 設定廣告選擇程序中使用的使用者出價信號。

繼承方法

來自 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 CustomAudience build ()

建構 CustomAudience 的例項。

傳回
CustomAudience	此值不能為 null。

擲回
NullPointerException	如果有任何非空值參數為空值
IllegalArgumentException	(如果到期時間早於啟用時間)
IllegalArgumentException	如果到期時間早於目前時間

setActivationTime

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

public CustomAudience.Builder setActivationTime (Instant activationTime)

設定時間 (截斷至毫秒)，之後 CustomAudience 就會放送廣告。

設為 null，可讓這個 CustomAudience 立即啟用並參與廣告選擇。

詳情請參閱 CustomAudience.getActivationTime()。

參數
activationTime	Instant：這個值可以是 null。

傳回
CustomAudience.Builder

setAds

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

public CustomAudience.Builder setAds (List<AdData> ads)

設定自訂目標對象放送的初始再行銷廣告。如未提供，則會指派空白清單。

詳情請參閱 CustomAudience.getAds()。

參數
ads	List：這個值可以是 null。

傳回
CustomAudience.Builder	此值不能為 null。

setBiddingLogicUri

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

public CustomAudience.Builder setBiddingLogicUri (Uri biddingLogicUri)

設定要擷取出價邏輯的 URI，以便在廣告選擇程序中使用。URI 必須採用 HTTPS。

詳情請參閱 CustomAudience.getBiddingLogicUri()。

參數
biddingLogicUri	Uri：此值不能為 null。

傳回
CustomAudience.Builder	此值不能為 null。

setBuyer

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

public CustomAudience.Builder setBuyer (AdTechIdentifier buyer)

設定買家 AdTechIdentifier。

詳情請參閱 CustomAudience.getBuyer()。

參數
buyer	AdTechIdentifier：此值不能為 null。

傳回
CustomAudience.Builder	此值不能為 null。

setDailyUpdateUri

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

public CustomAudience.Builder setDailyUpdateUri (Uri dailyUpdateUri)

設定每日更新 URI。URI 必須採用 HTTPS。

詳情請參閱 CustomAudience.getDailyUpdateUri()。

參數
dailyUpdateUri	Uri：此值不能為 null。

傳回
CustomAudience.Builder	此值不能為 null。

setExpirationTime

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

public CustomAudience.Builder setExpirationTime (Instant expirationTime)

設定時間 (縮短至毫秒)，之後應移除 CustomAudience。

詳情請參閱 CustomAudience.getExpirationTime()。

參數
expirationTime	Instant：這個值可以是 null。

傳回
CustomAudience.Builder	此值不能為 null。

setName

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

public CustomAudience.Builder setName (String name)

設定 CustomAudience 物件的名稱。

詳情請參閱 CustomAudience.getName()。

參數
name	String：此值不能為 null。

傳回
CustomAudience.Builder	此值不能為 null。

setTrustedBiddingData

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

public CustomAudience.Builder setTrustedBiddingData (TrustedBiddingData trustedBiddingData)

設定要查詢且用於廣告選擇程序的受信任出價資料。

詳情請參閱 CustomAudience.getTrustedBiddingData()。

參數
trustedBiddingData	TrustedBiddingData：這個值可以是 null。

傳回
CustomAudience.Builder	此值不能為 null。

setUserBiddingSignals

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

public CustomAudience.Builder setUserBiddingSignals (AdSelectionSignals userBiddingSignals)

設定廣告選擇程序中使用的使用者出價信號。

詳情請參閱 CustomAudience.getUserBiddingSignals()。

參數
userBiddingSignals	AdSelectionSignals：這個值可以是 null。

傳回
CustomAudience.Builder	此值不能為 null。