CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.customaudience.CustomAudience

代表自訂目標對象參與廣告選擇所需的資訊。

自訂目標對象是指具有類似興趣的摘要使用者群組。此類別是裝置中儲存的資料系列，要指定單一自訂目標對象放送廣告時，就必須有這些資料。

摘要

巢狀類別

class CustomAudience.Builder

CustomAudience 物件的建構工具。 

繼承的常數

欄位

public static final Creator<CustomAudience> CREATOR

公用方法

boolean equals(Object o)

檢查兩個 CustomAudience 物件是否包含相同的資訊。

Instant getActivationTime()

建立 CustomAudience 物件時，可選擇設定未來的啟用時間以完成延遲啟用。
List<AdData> getAds()

這個 AdData 物件清單是一份完整的廣告清單，當中會列出此 CustomAudience 在廣告選擇過程中放送的所有廣告。
Uri getBiddingLogicUri()

當自訂目標對象參與廣告選擇程序時，回傳用於擷取出價邏輯的目標 URI。
AdTechIdentifier getBuyer()

以「buyerexample.com」的格式依網域辨識買家。

Uri getDailyUpdateUri()

此 URI 會指向買家營運的伺服器，代管要於裝置端廣告選擇程序中使用的更新出價資料和廣告中繼資料。
Instant getExpirationTime()

超過有效期限後，自訂目標對象就不再符合資格，無法取得每日廣告/出價資料更新或參加廣告選擇程序。

String getName()

自訂目標對象的名稱是擁有者和買家在建立 CustomAudience 物件時提供的任意字串。
TrustedBiddingData getTrustedBiddingData()

受信任的出價資料由指向提供買家出價資料的受信任伺服器的 URI，以及向伺服器查詢的索引鍵清單組成。
AdSelectionSignals getUserBiddingSignals()

使用者出價信號是由買家提供，以在廣告選擇期間，於獨立的執行環境中由買家提供的 JavaScript 消耗。
int hashCode()

傳回 CustomAudience 物件資料的雜湊。

void writeToParcel(Parcel dest, int flags)

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

繼承方法

欄位

創作者

已新增至 API 級別 34
Ad Services Extensions 4 也已納入
public static final Creator<CustomAudience> CREATOR

公用方法

等於

已在 API 級別 34 中新增。
public boolean equals (Object o)

檢查兩個 CustomAudience 物件是否包含相同的資訊。

參數
o Object：要用來比較的參照物件。
傳回
boolean 如果此物件與 obj 引數相同，會傳回 true，否則傳回 false。

getActivationTime

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public Instant getActivationTime ()

建立 CustomAudience 物件時，可選擇設定未來的啟用時間以完成延遲啟用。如果不設定這個欄位，則會在加入時啟用 CustomAudience。

舉例來說，很久沒有使用的使用者可能會在達到閒置的門檻時才會啟用，此時自訂目標對象的廣告將參與廣告選擇程序，因此可能會將很久沒有使用的使用者重新導向至原始擁有者的應用程式。

啟用延遲時間最長為從初始建立算起 60 天。

指定時，啟用時間必須早於到期時間。

傳回
Instant 時間戳記 Instant 縮短至毫秒，之後自訂目標對象為已啟用。這個值可以是 null。

getAds

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public List<AdData> getAds ()

這個 AdData 物件清單是一份完整的廣告清單，當中會列出此 CustomAudience 在廣告選擇過程中放送的所有廣告。

如未指定或提供空白清單，CustomAudience 將不會參與廣告選擇流程，而是透過自訂目標對象的每日更新作業，提供有效的廣告清單。

傳回
List<AdData> 代表自訂目標對象目前放送廣告的 List 個物件 (共 AdData 個) 此值不能為 null。

getBiddingLogicUri

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public Uri getBiddingLogicUri ()

當自訂目標對象參與廣告選擇程序時，回傳用於擷取出價邏輯的目標 URI。URI 必須採用 HTTPS。

傳回
Uri 用來擷取買方出價邏輯的 URI 此值不能為 null。

getBuyer

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public AdTechIdentifier getBuyer ()

以「buyerexample.com」的格式依網域辨識買家。

傳回
AdTechIdentifier 包含自訂目標對象買家網域的 AdTechIdentifier 此值不能為 null。

getDailyUpdateUri

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public Uri getDailyUpdateUri ()

此 URI 會指向買家營運的伺服器，代管要於裝置端廣告選擇程序中使用的更新出價資料和廣告中繼資料。URI 必須採用 HTTPS。

傳回
Uri 自訂目標對象的每日更新 URI 此值不能為 null。

getExpirationTime

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public Instant getExpirationTime ()

超過有效期限後，自訂目標對象就不再符合資格，無法取得每日廣告/出價資料更新或參加廣告選擇程序。之後，自訂目標對象會在下次每日更新時從記憶體中刪除。

建立 CustomAudience 時，如果沒有提供到期時間，則到期時間會預設為啟用後的 60 天。

有效期限為從初次啟用起算的 60 天。

傳回
Instant 時間戳記 Instant，縮短至毫秒，之後自訂目標對象就會移除； 這個值可以是 null。

getName

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public String getName ()

自訂目標對象的名稱是擁有者和買方在建立 CustomAudience 物件時提供的任意字串。

傳回
String 自訂目標對象的字串名稱 此值不能為 null。

getTrustedBiddingData

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public TrustedBiddingData getTrustedBiddingData ()

受信任的出價資料由指向提供買家出價資料的受信任伺服器的 URI，以及向伺服器查詢的索引鍵清單組成。請注意，金鑰是任意 ID，只會在廣告選取期間，用於查詢受信任伺服器尋找買家的出價邏輯。

如未指定，CustomAudience 會透過自訂目標對象的每日更新提供可靠的出價資料，之後才能參與廣告選擇。

傳回
TrustedBiddingData 包含自訂目標對象受信任出價資料的 TrustedBiddingData 物件 這個值可以是 null。

getUserBiddingSignals

已新增至 API 級別 34
Ad Services Extensions 4 也已納入 
public AdSelectionSignals getUserBiddingSignals ()

使用者出價信號是由買家提供，以在廣告選擇期間，於獨立的執行環境中由買家提供的 JavaScript 消耗。

如果使用者出價信號不是有效的 JSON 物件，無法由買家的 JS 消耗，那麼自訂目標對象將不符合廣告選擇的資格。

如未指定，CustomAudience會透過自訂目標對象的每日更新提供使用者出價信號，否則廣告不會參與廣告選擇。

傳回
AdSelectionSignals AdSelectionSignals 物件，代表自訂目標對象的使用者出價信號 這個值可以是 null。

hashCode

已在 API 級別 34 中新增。
public int hashCode ()

傳回 CustomAudience 物件資料的雜湊。

傳回
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