UpdateAdCounterHistogramRequest

public class UpdateAdCounterHistogramRequest
extends Object

java.lang.Object
   ↳ android.adservices.adselection.UpdateAdCounterHistogramRequest

要求物件，該物件會包裝更新廣告計數器直方圖所需的必要引數。

廣告計數器直方圖是與廣告計數器鍵和廣告事件類型相關聯的歷來事件記錄，可在使用 Protected Audience API 時指出展示頻率上限篩選功能。

摘要

巢狀類別

class UpdateAdCounterHistogramRequest.Builder

UpdateAdCounterHistogramRequest 物件的建構工具。 

公用方法

boolean equals(Object o)

檢查 UpdateAdCounterHistogramRequest 物件是否包含相同的資訊。

int getAdEventType()

取得廣告事件類型，如果搭配使用該類型和廣告的計數器鍵，即可指出應更新直方圖。
long getAdSelectionId()

取得與所顯示廣告事件相關聯的廣告選擇 ID。
AdTechIdentifier getCallerAdTech()

取得呼叫端廣告技術實體的 AdTechIdentifier。
int hashCode()

傳回 UpdateAdCounterHistogramRequest 物件資料的雜湊。

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。

hashCode

public int hashCode ()

傳回 UpdateAdCounterHistogramRequest 物件資料的雜湊。

傳回
int 此物件的雜湊碼值。

toString

public String toString ()

傳回該物件的字串表示法。一般來說，toString 方法會「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要，並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。

類別 Object 的 toString 方法會傳回一個字串，當中包含由物件為執行個體的類別名稱、標誌字元「@」，以及物件雜湊程式碼的未簽署十六進位表示法。換句話說，此方法會傳回等於下列值的字串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())

傳回
String 物件的字串表示法。