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

摘要： 巢狀類別 |繼承常數 |欄位 |方法 |繼承方法

AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

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

---

包含廣告選擇程序的設定。

此類別的例項是由 SDK 建立，做為 AdSelectionManager 中 AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) 和 AdSelectionManager#reportImpression 方法的引數。

摘要

巢狀類別
class	AdSelectionConfig.Builder AdSelectionConfig 物件的建構工具。

繼承常數
來自介面： android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR 與 describeContents() 搭配使用的描述元位元：表示 Parcelable 物件的平面表示法包含檔案描述元。 int PARCELABLE_WRITE_RETURN_VALUE 與 writeToParcel(Parcel, int) 搭配使用的旗標：正在寫入的物件 是回傳值， 「Parcelable someFunction()」， 「void someFunction(out Parcelable)」，或 「void someFunction(inout Parcelable)」。

欄位
public static final Creator<AdSelectionConfig>	CREATOR

公用方法
int	describeContents() 說明此 Parcelable 中包含的特別物件種類 例項的管理表示法
boolean	equals(Object o) 指出是否有其他物件「等於」這個。
AdSelectionSignals	getAdSelectionSignals()
List<AdTechIdentifier>	getCustomAudienceBuyers()
Uri	getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals>	getPerBuyerSignals()
AdTechIdentifier	getSeller()
AdSelectionSignals	getSellerSignals()
Uri	getTrustedScoringSignalsUri()
int	hashCode() 傳回該物件的雜湊碼值。
void	writeToParcel(Parcel dest, int flags) 壓平合併此物件並加入至 Parcel。

繼承方法
來自類別： 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() 讓目前的執行緒等待，直到遭到喚醒為止。 通知或受到干擾。
來自介面： android.os.Parcelable abstract int describeContents() 說明此 Parcelable 中包含的特別物件種類 例項的管理表示法 abstract void writeToParcel(Parcel dest, int flags) 壓平合併此物件並加入至 Parcel。

欄位

CREATOR

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

public static final Creator<AdSelectionConfig> CREATOR

公用方法

describeContents

已加至 API 級別 34

public int describeContents ()

描述此 Parcelable 例項管理表示法中包含的特別物件種類。舉例來說，如果物件在 writeToParcel(android.os.Parcel, int) 的輸出內容中會包含檔案描述元，此方法的傳回值就必須包含 CONTENTS_FILE_DESCRIPTOR 位元。

傳回
int	位元遮罩，表示管理的特殊物件類型組合 這個 Parcelable 物件執行個體 值為 0 或 CONTENTS_FILE_DESCRIPTOR

equals

已加至 API 級別 34

public boolean equals (Object o)

指出是否有其他物件「等於」這個物件。

equals 方法針對非空值物件參照實作對等關係：

• 如果是自反關係：針對任何的非空參照值 x，x.equals(x) 應傳回 true。
• 如果是對稱關係：針對任何非空參照值 x 和 y，x.equals(y) 應傳回 true，前提是 y.equals(x) 必須傳回 true。
• 如果是可轉換關係：針對任何非空參照值 x、y 和 z，如果 x.equals(y) 傳回 true，且 y.equals(z) 傳回 true，則 x.equals(z) 應傳回 true。
• 如果是一致的關係：針對任何非空參照值 x 和 y，多次叫用 x.equals(y) 會持續傳回 true 或 false，但前提是，在該物件的 equals 比較中所使用的資訊均未經過修改。
• 針對任何非空參照值 x，x.equals(null) 應傳回 false。

類別 Object 的 equals 方法可對物件實作最明顯的對等關係；也就是說，針對任何非空參照值 x 和 y，只有在 x 和 y 參照相同的物件時 (x == y 的值為 true)，此方法才會傳回 true。

請注意，通常情況下，只要覆寫這個方法，就必須覆寫 hashCode 方法，以便維持 hashCode 方法的通用協定，亦即相等的物件必須有相等的雜湊碼。

參數
o	Object：要用來比較的參照物件。

傳回
boolean	如果此物件與 obj 引數相同，會傳回 true，否則傳回 false。

getAdSelectionSignals

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

public AdSelectionSignals getAdSelectionSignals ()

傳回
AdSelectionSignals	AdSelectionSignals 物件中的 JSON，從 AdSelectionConfig 擷取並消耗 從 DSP 擷取的 JS 邏輯，代表向參與 廣告選擇和報表流程中的買方 此值不能為 null。

getCustomAudienceBuyers

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

public List<AdTechIdentifier> getCustomAudienceBuyers ()

傳回
List<AdTechIdentifier>	賣方平台允許參與廣告的自訂目標對象買方清單 選取程序 此值不能為 null。

getDecisionLogicUri

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

public Uri getDecisionLogicUri ()

傳回
Uri	用來擷取內含賣方/SSP ScoreAd 函式的 JS 程式碼的 URI 會在廣告選擇和回報程序期間 此值不能為 null。

getPerBuyerSignals

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

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

傳回
Map<AdTechIdentifier, AdSelectionSignals>	買方和 AdSelectionSignals 對應，擷取自 AdSelectionConfig 設定 擷取自 DSP 的 JS 邏輯，代表每個 買方會在廣告選擇期間 (例如出價下限、廣告選擇) 類型等)。 此值不能為 null。

getSeller

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

public AdTechIdentifier getSeller ()

傳回
AdTechIdentifier	賣方的 AdTechIdentifier，例如「www.example-ssp.com」 此值不能為 null。

getSellerSignals

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

public AdSelectionSignals getSellerSignals ()

傳回
AdSelectionSignals	AdSelectionSignals 物件中的 JSON，由賣方平台提供，並由 JS 使用 從賣方平台擷取的邏輯，代表賣方平台在廣告中使用的任何資訊 調整廣告選擇程序結果 (例如品牌安全) 的評分流程 檢查、排除的內容相關廣告)。 此值不能為 null。

getTrustedScoringSignalsUri

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

public Uri getTrustedScoringSignalsUri ()

傳回
Uri	賣方受信任信號的 URI 端點，其中廣告素材專屬即時資訊 系統會從中擷取哪些資訊 此值不能為 null。

hashCode

已加至 API 級別 34

public int hashCode ()

傳回該物件的雜湊碼值。此方法支援使用雜湊資料表，例如 HashMap 提供的雜湊資料表。

hashCode 的一般約定如下：

• 在 Java 應用程式執行期間，如果多次叫用同一物件，hashCode 方法必須持續傳回相同的整數；前提是在該物件上用於 equals 比較的資訊均未經修改。在同一個應用程式兩次執行作業之間，此整數無需保持一致。
• 如果根據 equals(Object) 方法，兩個物件是相同的，則針對兩個物件呼叫 hashCode 方法時，必須產生相同的整數結果。
• 如果根據 equals(java.lang.Object) 方法，兩個物件不相同，則針對兩個物件呼叫 hashCode 方法時，無需產生不同的整數結果。不過，程式設計人員也應瞭解，如果為不相等的物件產生不同的整數結果，可能會改善雜湊資料表的效能。

只要合理可行，類別 Object 定義的 hashCode 方法會針對不同的物件傳回不同的整數 (在某個時間點上，hashCode 不一定會實作為物件記憶體位址的某個函式)。

傳回
int	此物件的雜湊碼值。

writeToParcel

已加至 API 級別 34

public void writeToParcel (Parcel dest, 
                int flags)

壓平合併此物件並加入至 Parcel。

參數
dest	Parcel：此值不能為 null。
flags	int：應如何編寫物件的相關其他標記。可以是 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。 值可以是 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE 的組合，以及 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES