已加至 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>	SSP 允許參與廣告選擇程序的自訂目標對象買方清單 此值不能為 null。

getDecisionLogicUri

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

public Uri getDecisionLogicUri ()

傳回
Uri	用於擷取包含賣方/SSP ScoreAd 函式的 JavaScript 程式碼的 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 是由 SSP 提供，並由從 SSP 擷取的 JS 邏輯使用，代表 SSP 在廣告評分程序中用於調整廣告選擇程序結果的任何資訊 (例如品牌安全檢查、排除的內容相關廣告)。此值不能為 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