CustomAudience
public
final
class
CustomAudience
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.customaudience.CustomAudience |
代表自訂目標對象參與廣告選擇所需的資訊。
自訂目標對象是指具有類似興趣的摘要使用者群組。此類別是裝置中儲存的資料系列,要指定單一自訂目標對象放送廣告時,就必須有這些資料。
摘要
巢狀類別 | |
---|---|
class |
CustomAudience.Builder
|
繼承的常數 |
---|
欄位 | |
---|---|
public
static
final
Creator<CustomAudience> |
CREATOR
|
公用方法 | |
---|---|
boolean
|
equals(Object o)
檢查兩個 |
Instant
|
getActivationTime()
建立 |
List<AdData>
|
getAds()
此 |
Uri
|
getBiddingLogicUri()
當自訂目標對象參與 廣告選擇程序。 |
AdTechIdentifier
|
getBuyer()
以「buyerexample.com」的格式依網域辨識買家。 |
Uri
|
getDailyUpdateUri()
此 URI 會指向買家營運的伺服器,代管更新後的出價資料和廣告中繼資料 用於裝置端廣告選擇程序中的幾項設定 |
Instant
|
getExpirationTime()
超過有效期限後,自訂目標對象就不再符合每日使用資格 廣告/出價資料更新或參與廣告選擇程序。 |
String
|
getName()
自訂目標對象的名稱是擁有者和買家在建立時提供的任意字串
|
TrustedBiddingData
|
getTrustedBiddingData()
受信任的出價資料由指向提供買家受信任伺服器的 URI 組成出價資料 以及用來查詢伺服器的索引鍵清單 |
AdSelectionSignals
|
getUserBiddingSignals()
使用者出價信號是由買方選擇性提供,用於買方提供的信號 隔離執行環境中的廣告選擇期間的 JavaScript。 |
int
|
hashCode()
傳回 |
void
|
writeToParcel(Parcel dest, int flags)
壓平合併此物件並加入至 Parcel。 |
繼承方法 | |
---|---|
欄位
CREATOR
public static final Creator<CustomAudience> CREATOR
公用方法
equals
public boolean equals (Object o)
檢查兩個 CustomAudience
物件是否包含相同的資訊。
參數 | |
---|---|
o |
Object :要用來比較的參照物件。 |
傳回 | |
---|---|
boolean |
如果此物件與 obj 引數相同,會傳回 true ,否則傳回 false 。 |
getActivationTime
public Instant getActivationTime ()
建立 CustomAudience
物件時,可選擇設定未來的啟用時間,從而延後啟用。如果不設定這個欄位,則會在加入時啟用 CustomAudience
。
舉例來說,很久沒有使用的使用者可能會在達到閒置的門檻時才會啟用,此時自訂目標對象的廣告將參與廣告選擇程序,因此可能會將很久沒有使用的使用者重新導向至原始擁有者的應用程式。
啟用延遲時間最長為從初始建立算起 60 天。
指定時,啟用時間必須早於到期時間。
傳回 | |
---|---|
Instant |
時間戳記 Instant ,縮短至毫秒,之後自訂值
目標對像已啟用
這個值可以是 null 。 |
getAds
public List<AdData> getAds ()
這個 AdData
物件清單是一份完整的廣告清單,當中會列出此 CustomAudience
在廣告選擇程序中提供的所有廣告。
如未指定或提供空白清單,CustomAudience
將不會參與廣告選擇流程,而是透過自訂目標對象的每日更新作業,提供有效的廣告清單。
傳回 | |
---|---|
List<AdData> |
AdData 的 List 物件,代表目前由
自訂目標對象
此值不能為 null 。 |
getBiddingLogicUri
public Uri getBiddingLogicUri ()
當自訂目標對象參與廣告選擇程序時,傳回用於擷取出價邏輯的目標 URI。URI 必須採用 HTTPS。
傳回 | |
---|---|
Uri |
用於擷取買方出價邏輯的 URI
此值不能為 null 。 |
getBuyer
public AdTechIdentifier getBuyer ()
以「buyerexample.com」格式的網域辨識買方。
傳回 | |
---|---|
AdTechIdentifier |
包含自訂目標對象買家網域的 AdTechIdentifier
此值不能為 null 。 |
getDailyUpdateUri
public Uri getDailyUpdateUri ()
此 URI 指向買方營運的伺服器,伺服器中代管要於裝置端廣告選擇程序中使用的更新出價資料和廣告中繼資料。URI 必須採用 HTTPS。
傳回 | |
---|---|
Uri |
自訂目標對象的每日更新 URI
此值不能為 null 。 |
getExpirationTime
public Instant getExpirationTime ()
有效期限過後,自訂目標對象的每日廣告/出價資料就會停止更新,自訂目標對象也將不再參與廣告選擇程序。之後,自訂目標對象會在下次每日更新時從記憶體中刪除。
建立 CustomAudience
時,如果沒有提供到期時間,則到期時間會預設為啟用後的 60 天。
有效期限為從初次啟用起算的 60 天。
傳回 | |
---|---|
Instant |
時間戳記 Instant ,縮短至毫秒,之後自訂值
應移除目標對象
這個值可以是 null 。 |
getName
public String getName ()
自訂目標對象的名稱是擁有者和買方在建立 CustomAudience
物件時提供的任意字串。
傳回 | |
---|---|
String |
自訂目標對象的字串名稱
此值不能為 null 。 |
getTrustedBiddingData
public TrustedBiddingData getTrustedBiddingData ()
受信任的出價資料包含指向受信任伺服器 (提供買方出價資料) 的 URI,以及用於向伺服器查詢的索引鍵清單。請注意,金鑰是任意 ID,只會在廣告選取期間,用於查詢受信任伺服器尋找買家的出價邏輯。
如未指定,CustomAudience
會透過自訂目標對象的每日更新提供可靠的出價資料,之後才能參與廣告選擇。
傳回 | |
---|---|
TrustedBiddingData |
包含自訂目標對象受信任出價的 TrustedBiddingData 物件
資料
這個值可以是 null 。 |
getUserBiddingSignals
public AdSelectionSignals getUserBiddingSignals ()
使用者出價信號是由買方選擇性提供,在廣告選擇期間由買方提供的 JavaScript 在獨立執行環境中使用。
如果使用者出價信號不是有效的 JSON 物件,無法由買家的 JS 消耗,那麼自訂目標對象將不符合廣告選擇的資格。
如未指定,CustomAudience
會透過自訂目標對象的每日更新提供使用者出價信號,否則廣告不會參與廣告選擇。
傳回 | |
---|---|
AdSelectionSignals |
AdSelectionSignals 物件,代表
自訂目標對象
這個值可以是 null 。 |
writeToParcel
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 |