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

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

廣告選擇設定

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。

欄位

創作者

已新增至 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

等於

已在 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。

getCustomAudience 買家

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

public List<AdTechIdentifier> getCustomAudienceBuyers ()

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

getDecisionLogicUri

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

public Uri getDecisionLogicUri ()

傳回
Uri	這個 URI 用於擷取 JS 程式碼，當中包含在廣告選擇和報表程序期間使用的賣家/SSP ScoreAd 函式 此值不能為 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 物件 (由賣方平台提供及從賣方平台擷取的 JS 邏輯所使用) 中的 JSON，代表賣方平台在廣告評分程序中使用的所有資訊，可微調廣告選擇程序的結果 (例如品牌安全檢查、排除內容相關廣告)。此值不能為 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