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 物件的建構工具。 

繼承常數

欄位

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。

繼承方法

欄位

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