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

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

AdData.Builder

public static final class AdData.Builder
extends Object

java.lang.Object
↳	android.adservices.common.AdData.Builder

---

AdData 物件的建構工具。

摘要

公用建構函式
Builder()

公用方法
AdData	build() 建構 AdData 物件。
AdData.Builder	setAdCounterKeys(Set<Integer> adCounterKeys) 設定用於計算事件的鍵組合。
AdData.Builder	setAdFilters(AdFilters adFilters) 設定所有與廣告相關的 AdFilters。
AdData.Builder	setAdRenderId(String adRenderId) 設定用於伺服器競價的廣告顯示 ID 詳情請參閱 AdData#getAdRenderId()。
AdData.Builder	setMetadata(String metadata) 設定廣告選擇程序期間使用的買家廣告中繼資料。
AdData.Builder	setRenderUri(Uri renderUri) 設定指向廣告算繪素材資源的 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 AdData build ()

建構 AdData 物件。

傳回
AdData	此值不能為 null。

擲回
NullPointerException	建立時如果有任何必要參數為 null

setAdCounterKeys

已加至 Android UpsideDownCakePrivacySandbox

public AdData.Builder setAdCounterKeys (Set<Integer> adCounterKeys)

設定用於計算事件的鍵組合。

每個廣告最多能與 10 個廣告計數器鍵建立關聯。

詳情請參閱 AdData.getAdCounterKeys()。

參數
adCounterKeys	Set：此值不能為 null。

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

設定 AdFilters

已加至 Android UpsideDownCakePrivacySandbox

public AdData.Builder setAdFilters (AdFilters adFilters)

設定所有與廣告相關的 AdFilters。

詳情請參閱 AdData.getAdFilters()。

參數
adFilters	AdFilters：這個值可以是 null。

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

setAdRenderId

已加至 Android UpsideDownCakePrivacySandbox

public AdData.Builder setAdRenderId (String adRenderId)

設定用於伺服器競價的廣告顯示 ID

詳情請參閱 AdData#getAdRenderId()。

參數
adRenderId	String：這個值可以是 null。

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

setMetadata

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

public AdData.Builder setMetadata (String metadata)

設定廣告選擇程序期間使用的買家廣告中繼資料。

中繼資料必須是以字串序列化的有效 JSON 物件。中繼資料代表廣告專屬的出價資訊，會在廣告選擇期間用於產生出價，並在買方 JavaScript 邏輯中使用。買方 JavaScript 邏輯是在獨立的執行環境中執行。

如果中繼資料不是買方 JS 可消耗的有效 JSON 物件，則 就無法放送廣告。

詳情請參閱 AdData.getMetadata()。

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

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

setRenderUri

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

public AdData.Builder setRenderUri (Uri renderUri)

設定指向廣告算繪素材資源的 URI。URI 必須採用 HTTPS。

詳情請參閱 AdData.getRenderUri()。

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

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