UpdateAdCounterHistogramRequest
public
class
UpdateAdCounterHistogramRequest
extends Object
java.lang.Object | |
↳ | android.adservices.adselection.UpdateAdCounterHistogramRequest |
要求物件,該物件會包裝更新廣告計數器直方圖所需的必要引數。
廣告計數器直方圖是與廣告計數器鍵和廣告事件類型相關聯的歷來事件記錄,可在使用 Protected Audience API 時指出展示頻率上限篩選功能。
摘要
巢狀類別 | |
---|---|
class |
UpdateAdCounterHistogramRequest.Builder
|
公用方法 | |
---|---|
boolean
|
equals(Object o)
檢查 |
int
|
getAdEventType()
取得廣告事件類型,如果搭配使用該類型和廣告的計數器鍵,即可指出應更新直方圖。 |
long
|
getAdSelectionId()
取得與所顯示廣告事件相關聯的廣告選擇 ID。 |
AdTechIdentifier
|
getCallerAdTech()
取得呼叫端廣告技術實體的 |
int
|
hashCode()
傳回 |
String
|
toString()
傳回該物件的字串表示法。 |
繼承方法 | |
---|---|
公用方法
等於
public boolean equals (Object o)
檢查 UpdateAdCounterHistogramRequest
物件是否包含相同的資訊。
參數 | |
---|---|
o |
Object :要用來比較的參照物件。 |
傳回 | |
---|---|
boolean |
如果此物件與 obj 引數相同,會傳回 true ,否則傳回 false 。 |
getAdEventType
public int getAdEventType ()
取得廣告事件類型,如果搭配使用該類型和廣告的計數器鍵,即可指出應更新直方圖。
傳回 | |
---|---|
int |
值為 android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_INVALID、FrequencyCapFilters.AD_EVENT_TYPE_WIN 、FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION 、FrequencyCapFilters.AD_EVENT_TYPE_VIEW 、FrequencyCapFilters.AD_EVENT_TYPE_CLICK 、android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MIN 或 android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MAX |
getAdSelectionId
public long getAdSelectionId ()
取得與所顯示廣告的事件相關聯的廣告選擇 ID。
如要進一步瞭解廣告選擇 ID,請參閱 AdSelectionOutcome
。
廣告必須在過去 24 小時內從 Protected Audience 廣告選擇過程中選取,且廣告選擇呼叫必須透過與目前的呼叫應用程式相同的應用程式啟動。針對廣告選擇 ID 指定的廣告所指定廣告計數器鍵,系統會為 getAdEventType()
更新廣告事件類型的事件直方圖,以便用於 Protected Audience 展示頻率上限篩選功能。
傳回 | |
---|---|
long |
getCallerAdTech
public AdTechIdentifier getCallerAdTech ()
取得呼叫端廣告技術實體的 AdTechIdentifier
。
使用這個 UpdateAdCounterHistogramRequest
物件的廣告技術必須向 Privacy Sandbox 註冊,並獲準代表呼叫應用程式執行動作。指定的廣告技術不一定要與擁有顯示廣告的買方或由 getAdSelectionId()
傳回所傳回 ID 相關聯的賣方相同。
如要進一步瞭解 API 規定和例外狀況,請參閱 AdSelectionManager.updateAdCounterHistogram(android.adservices.adselection.UpdateAdCounterHistogramRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver)
。
傳回 | |
---|---|
AdTechIdentifier |
此值不能為 null 。 |
toString
public String toString ()
傳回該物件的字串表示法。一般來說,toString
方法會「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要,並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。
類別 Object
的 toString
方法會傳回一個字串,當中包含由物件為執行個體的類別名稱、標誌字元「@
」,以及物件雜湊程式碼的未簽署十六進位表示法。換句話說,此方法會傳回等於下列值的字串:
getClass().getName() + '@' + Integer.toHexString(hashCode())
傳回 | |
---|---|
String |
物件的字串表示法。 |