按鍵展示頻率上限
public
final
class
KeyedFrequencyCap
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.common.KeyedFrequencyCap |
特定廣告計數器鍵的展示頻率上限。
展示頻率上限會定義事件在特定時間間隔內可發生的頻率上限。如果超過展示頻率上限,系統就會在廣告選擇中篩除相關廣告。
摘要
巢狀類別 | |
---|---|
class |
KeyedFrequencyCap.Builder
建立 |
繼承常數 |
---|
欄位 | |
---|---|
public
static
final
Creator<KeyedFrequencyCap> |
CREATOR
|
公用方法 | |
---|---|
boolean
|
equals(Object o)
檢查 |
int
|
getAdCounterKey()
傳回要套用展示頻率上限的廣告計數器鍵。 |
Duration
|
getInterval()
傳回間隔,格式為 |
int
|
getMaxCount()
傳回指定時間間隔內允許的事件發生數量上限。 |
int
|
hashCode()
傳回 |
String
|
toString()
傳回該物件的字串表示法。 |
void
|
writeToParcel(Parcel dest, int flags)
壓平合併此物件並加入至 Parcel。 |
繼承方法 | |
---|---|
欄位
公用方法
等於
public boolean equals (Object o)
檢查 KeyedFrequencyCap
物件是否包含相同的資訊。
參數 | |
---|---|
o |
Object :要用來比較的參照物件。 |
傳回 | |
---|---|
boolean |
如果此物件與 obj 引數相同,會傳回 true ,否則傳回 false 。 |
getAdCounterKey
public int getAdCounterKey ()
傳回要套用展示頻率上限的廣告計數器鍵。
廣告計數器鍵是由廣告技術定義,這個任意數字 ID 會定義先前在裝置上計算及保留的任何條件。如果裝置端數量超過特定時間間隔內的數量上限,就表示已超過展示頻率上限。
傳回 | |
---|---|
int |
此值不能為 null 。 |
getInterval
public Duration getInterval ()
傳回間隔,格式為 Duration
,且會截斷至最接近的秒數,系統會據此計算展示頻率上限。
計算這個展示頻率上限時,系統會將保留事件數量計入最近的時間間隔。如果廣告技術先前發生的相符事件數量大於 getMaxCount()
傳回的數量,就表示已超過展示頻率上限,廣告也將不符合參與廣告選擇的資格。
傳回 | |
---|---|
Duration |
此值不能為 null 。 |
getMaxCount
public int getMaxCount ()
傳回指定時間間隔內允許的事件發生數量上限。
如果在 getInterval()
定義的時間間隔內,裝置上還有計算其他符合廣告計數器鍵的事件和廣告事件類型,就表示已超過展示頻率上限,廣告也將不符合參與廣告選擇的資格。
舉例來說,如果廣告指定的篩選條件是一小時內的數量上限為兩次,而事件計算次數在廣告選擇程序前一小時內達兩次以上,該廣告就不符合參與廣告選擇的資格。
傳回 | |
---|---|
int |
toString
public String toString ()
傳回該物件的字串表示法。一般來說,toString
方法會「以文字方式代表」這個物件的字串。顯示的結果應簡明扼要,並提供方便使用者閱讀的豐富資訊。建議所有子類別都覆寫此方法。
類別 Object
的 toString
方法會傳回一個字串,當中包含由物件為執行個體的類別名稱、標誌字元「@
」,以及物件雜湊程式碼的未簽署十六進位表示法。換句話說,此方法會傳回等於下列值的字串:
getClass().getName() + '@' + Integer.toHexString(hashCode())
傳回 | |
---|---|
String |
物件的字串表示法。 |
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 |