Tần suấtCapFilters
public
final
class
FrequencyCapFilters
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.common.FrequencyCapFilters |
Vùng chứa cho các bộ lọc quảng cáo dựa trên giới hạn tần suất.
Bạn không thể liên kết quá 20 bộ lọc giới hạn tần suất với một quảng cáo.
Bộ lọc giới hạn tần suất kết hợp một loại sự kiện với danh sách các đối tượng KeyedFrequencyCap
để xác định một tập hợp các bộ lọc quảng cáo. Nếu một quảng cáo cụ thể bị vượt quá
bất kỳ giới hạn nào trong số này,
quảng cáo sẽ bị xoá khỏi nhóm quảng cáo được gửi đến chức năng đặt giá thầu của công nghệ quảng cáo của người mua.
Tóm tắt
Lớp lồng ghép | |
---|---|
class |
FrequencyCapFilters.Builder
Trình tạo để tạo các đối tượng |
Hằng số | |
---|---|
int |
AD_EVENT_TYPE_CLICK
|
int |
AD_EVENT_TYPE_IMPRESSION
|
int |
AD_EVENT_TYPE_VIEW
|
int |
AD_EVENT_TYPE_WIN
Loại sự kiện quảng cáo WIN được tự động điền trong dịch vụ Protected Audience cho mọi quảng cáo giành chiến thắng được trả về từ lựa chọn quảng cáo Protected Audience. |
Hằng số kế thừa |
---|
Các trường | |
---|---|
public
static
final
Creator<FrequencyCapFilters> |
CREATOR
|
Phương thức công khai | |
---|---|
boolean
|
equals(Object o)
Kiểm tra xem các đối tượng |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForClickEvents()
Lấy danh sách đối tượng |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForImpressionEvents()
Lấy danh sách đối tượng |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForViewEvents()
Lấy danh sách đối tượng |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForWinEvents()
Lấy danh sách đối tượng |
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 | |
---|---|
Hằng số
Nhấp vào AD_EVENT_TYPE_CLICK
public static final int AD_EVENT_TYPE_CLICK
Giá trị không đổi: 3 (0x00000003)
AD_EVENT_TYPE_impression
public static final int AD_EVENT_TYPE_IMPRESSION
Giá trị không đổi: 1 (0x00000001)
CHẾ ĐỘ XEM AD_EVENT_TYPE
public static final int AD_EVENT_TYPE_VIEW
Giá trị không đổi: 2 (0x00000002)
AD_EVENT_TYPE_WIN
public static final int AD_EVENT_TYPE_WIN
Loại sự kiện quảng cáo WIN được tự động điền trong dịch vụ Protected Audience cho mọi quảng cáo giành chiến thắng được trả về từ lựa chọn quảng cáo Protected Audience.
Bạn không nên dùng tính năng này để cập nhật biểu đồ bộ đếm quảng cáo theo cách thủ công.
Giá trị hằng số: 0 (0x00000000)
Trường
CREATOR
public static final Creator<FrequencyCapFilters> CREATOR
Phương thức công khai
equals
public boolean equals (Object o)
Kiểm tra xem các đối tượng FrequencyCapFilters
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; nếu không thì false . |
getKeyedFrequencyCapsForClickEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()
Lấy danh sách đối tượng KeyedFrequencyCap
sẽ lọc theo loại sự kiện AD_EVENT_TYPE_CLICK
.
Các giới hạn tần suất này áp dụng cho các sự kiện liên quan đến một lượt nhấp được diễn giải bởi
công nghệ quảng cáo. Các sự kiện nhấp chuột được tính khi API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
được gọi bằng loại sự kiện AD_EVENT_TYPE_CLICK
.
Giá trị trả về | |
---|---|
List<KeyedFrequencyCap> |
Giá trị này không được là null . |
getKeyedfrequencyCapsForImpressionEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()
Lấy danh sách đối tượng KeyedFrequencyCap
sẽ lọc theo loại sự kiện AD_EVENT_TYPE_IMPRESSION
.
Các giới hạn tần suất này áp dụng cho các sự kiện liên quan đến một lượt hiển thị được diễn giải bởi công nghệ quảng cáo.
Xin lưu ý rằng các sự kiện sẽ không được tự động tính khi gọi AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver)
. Thay vào đó, loại sự kiện AD_EVENT_TYPE_IMPRESSION
phải
được cập nhật bằng API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
.
Giá trị trả về | |
---|---|
List<KeyedFrequencyCap> |
Giá trị này không được là null . |
getKeyedFrequencyCapsForViewEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()
Lấy danh sách đối tượng KeyedFrequencyCap
sẽ lọc theo loại sự kiện AD_EVENT_TYPE_VIEW
.
Các giới hạn tần suất này áp dụng cho các sự kiện tương quan với một chế độ xem được diễn giải bởi
công nghệ quảng cáo. Các sự kiện lượt xem được tính khi API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
được gọi bằng loại sự kiện AD_EVENT_TYPE_VIEW
.
Giá trị trả về | |
---|---|
List<KeyedFrequencyCap> |
Giá trị này không được là null . |
getKeyedFrequencyCapsForWinEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()
Lấy danh sách đối tượng KeyedFrequencyCap
sẽ lọc theo loại sự kiện AD_EVENT_TYPE_WIN
.
Các giới hạn tần suất này áp dụng cho những sự kiện của những quảng cáo được chọn là chiến thắng trong quảng cáo lựa chọn. Quảng cáo giành chiến thắng được sử dụng để tự động tăng các khoá bộ đếm được liên kết trên loại sự kiện giành chiến thắng.
Lưu ý rằng bạn không thể cập nhật loại sự kiện AD_EVENT_TYPE_WIN
theo cách thủ công bằng cách sử dụng
API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)
.
Giá trị trả về | |
---|---|
List<KeyedFrequencyCap> |
Giá trị này không được là null . |
hashCode
public int hashCode ()
Trả về hàm băm của dữ liệu đối tượng FrequencyCapFilters
.
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 |