KeyedFrequencyCap
public
final
class
KeyedFrequencyCap
extends Object
implements
Parcelable
| java.lang.Object | |
| ↳ | android.adservices.common.KeyedFrequencyCap |
Giới hạn tần suất cho một khoá bộ đếm quảng cáo cụ thể.
Giới hạn tần suất xác định tỷ lệ tối đa mà một sự kiện có thể xảy ra trong một khoảng thời gian nhất định. Nếu vượt quá giới hạn tần suất, quảng cáo được liên kết sẽ bị lọc khỏi lựa chọn quảng cáo.
Tóm tắt
Lớp lồng ghép | |
|---|---|
class |
KeyedFrequencyCap.Builder
Trình tạo để tạo các đối tượng |
Hằng số kế thừa |
|---|
Các trường | |
|---|---|
public
static
final
Creator<KeyedFrequencyCap> |
CREATOR
|
Phương thức công khai | |
|---|---|
boolean
|
equals(Object o)
Kiểm tra xem các đối tượng |
int
|
getAdCounterKey()
Trả về khoá bộ đếm quảng cáo mà giới hạn tần suất được áp dụng. |
Duration
|
getInterval()
Trả về khoảng thời gian, dưới dạng |
int
|
getMaxCount()
Trả về số lần xuất hiện tối đa được phép của sự kiện trong một khoảng thời gian nhất định. |
int
|
hashCode()
Trả về hàm băm của dữ liệu đối tượng |
String
|
toString()
Trả về một chuỗi đại diện của đối tượng. |
void
|
writeToParcel(Parcel dest, int flags)
Làm phẳng đối tượng này thành một Gói (Parcel). |
Phương thức kế thừa | |
|---|---|
Trường
CREATOR
public static final Creator<KeyedFrequencyCap> CREATOR
Phương thức công khai
equals
public boolean equals (Object o)
Kiểm tra xem các đối tượng KeyedFrequencyCap có chứa cùng một thông tin hay không.
| Tham số | |
|---|---|
o |
Object: đối tượng tham chiếu cần so sánh. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu đối tượng này giống với đối số obj; còn nếu không thì là false. |
getAdCounterKey
public int getAdCounterKey ()
Trả về khoá bộ đếm quảng cáo mà giới hạn tần suất được áp dụng.
Khoá bộ đếm quảng cáo do một công nghệ quảng cáo xác định, đồng thời là một giá trị nhận dạng tuỳ ý ở dạng số, có tác dụng xác định mọi tiêu chí mà trước đó có thể được tính đến và duy trì trên thiết bị. Nếu số lần trên thiết bị vượt quá số lần tối đa trong một khoảng thời gian nhất định, thì nghĩa là giới hạn tần suất đã bị vượt quá.
| Giá trị trả về | |
|---|---|
int |
Giá trị này không được là null. |
getInterval
public Duration getInterval ()
Trả về khoảng thời gian, dưới dạng Duration. Giá trị này sẽ được cắt bớt đến giây gần nhất mà theo đó, giới hạn tần suất được tính.
Khi tính giới hạn tần suất này, số lượng sự kiện được duy trì sẽ được tính trong khoảng thời gian gần đây nhất. Nếu số lượng sự kiện trùng khớp xảy ra trước đó của một công nghệ quảng cáo lớn hơn con số mà getMaxCount() trả về, thì nghĩa là giới hạn tần suất đã bị vượt quá và quảng cáo đó sẽ không đủ điều kiện cho hoạt động lựa chọn quảng cáo.
| Giá trị trả về | |
|---|---|
Duration |
Giá trị này không được là null. |
getMaxCount
public int getMaxCount ()
Trả về số lần xuất hiện tối đa được phép của sự kiện trong một khoảng thời gian nhất định.
Nếu có thêm các sự kiện trùng khớp với khoá bộ đếm quảng cáo và kiểu sự kiện quảng cáo được tính trên thiết bị trong khoảng thời gian do getInterval() xác định, thì giới hạn tần suất đã bị vượt quá và quảng cáo đó sẽ không đủ điều kiện cho lựa chọn quảng cáo.
Ví dụ: một quảng cáo chỉ định giá trị số lượng tối đa là 2 trong vòng 1 giờ cho bộ lọc sẽ không đủ điều kiện cho hoạt động lựa chọn quảng cáo nếu sự kiện đó đã được đếm từ 2 lần trở lên trong vòng 1 giờ trước khi quá trình lựa chọn quảng cáo diễn ra.
| Giá trị trả về | |
|---|---|
int |
|
hashCode
public int hashCode ()
Trả về hàm băm của dữ liệu đối tượng KeyedFrequencyCap.
| Giá trị trả về | |
|---|---|
int |
một giá trị mã băm cho đối tượng này. |
toString
public String toString ()
Trả về một chuỗi đại diện của đối tượng. Nhìn chung, phương thức toString sẽ trả về một chuỗi "đại diện bằng văn bản" cho đối tượng này. Kết quả trình bày phải ngắn gọn nhưng đầy đủ thông tin để người đọc dễ đọc.
Tất cả các lớp con đều nên ghi đè phương thức này.
Phương thức toString dành cho lớp Object trả về một chuỗi bao gồm tên của lớp mà trong đó đối tượng là một thực thể, ký tự ký hiệu '@' và giá trị biểu thị mã băm của đối tượng ở dạng thập lục phân chưa ký. Nói cách khác, phương thức này sẽ trả về một chuỗi bằng giá trị của:
getClass().getName() + '@' + Integer.toHexString(hashCode())
| Giá trị trả về | |
|---|---|
String |
một giá trị biểu thị đối tượng ở dạng chuỗi. |
writeToParcel
public void writeToParcel (Parcel dest, int flags)
Làm phẳng đối tượng này thành một Gói (Parcel).
| Tham số | |
|---|---|
dest |
Parcel: Giá trị này không được là null. |
flags |
int: Cờ bổ sung về cách viết đối tượng.
Có thể là 0 hoặc Parcelable.PARCELABLE_WRITE_RETURN_VALUE.
Giá trị có thể là 0 hoặc tổ hợp Parcelable.PARCELABLE_WRITE_RETURN_VALUE và android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |