ตัวกรองความถี่สูงสุด

public final class FrequencyCapFilters
extends Object implements Parcelable

java.lang.Object
↳ android.adservices.common.FrequencyCapFilter

คอนเทนเนอร์สำหรับตัวกรองโฆษณาที่อิงจากความถี่สูงสุด

ตัวกรองความถี่สูงสุดจะเชื่อมโยงกับโฆษณาเดียวได้ไม่เกิน 20 รายการ

ตัวกรองความถี่สูงสุดจะรวมประเภทเหตุการณ์เข้ากับรายการออบเจ็กต์ KeyedFrequencyCap รายการ เพื่อกำหนดชุดของตัวกรองโฆษณา หากความถี่สูงสุดในโฆษณาเหล่านี้เกินกำหนด โฆษณาจะถูกนำออกจากกลุ่มโฆษณาที่ส่งไปยังฟังก์ชันการเสนอราคาของ AdTech ของผู้ซื้อ

สรุป

ชั้นเรียนที่ซ้อนกัน

class FrequencyCapFilters.Builder

เครื่องมือสร้างสำหรับการสร้างวัตถุ FrequencyCapFilters รายการ 

ค่าคงที่

int AD_EVENT_TYPE_CLICK

int AD_EVENT_TYPE_IMPRESSION

int AD_EVENT_TYPE_VIEW

int AD_EVENT_TYPE_WIN

ระบบจะสร้างประเภทเหตุการณ์โฆษณา WIN โดยอัตโนมัติภายในบริการ Protected Audience สําหรับ โฆษณาที่ชนะซึ่งส่งกลับมาจากการเลือกโฆษณา Protected Audience

ค่าคงที่ที่รับช่วงมา

ช่อง

public static final Creator<FrequencyCapFilters> CREATOR

วิธีการสาธารณะ

boolean equals(Object o)

ตรวจสอบว่าออบเจ็กต์ FrequencyCapFilters มีข้อมูลเดียวกันหรือไม่

List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_CLICK

List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_IMPRESSION

List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_VIEW

List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_WIN

int hashCode()

แสดงผลแฮชของข้อมูลของออบเจ็กต์ FrequencyCapFilters

String toString()

แสดงผลตัวแทนสตริงของออบเจ็กต์

void writeToParcel(Parcel dest, int flags)

แยกวัตถุนี้ลงในแปลงที่ดิน

วิธีการที่รับมา

ค่าคงที่

ประเภทกิจกรรมการคลิก

เพิ่มใน Android UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_CLICK

มูลค่าคงที่: 3 ครั้ง (0x00000003)

AD_EVENT_TYPE_IMPRESSION

เพิ่มใน Android UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_IMPRESSION

มูลค่าคงที่: 1 ครั้ง (0x00000001)

มุมมองประเภทกิจกรรมโฆษณา

เพิ่มใน Android UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_VIEW

มูลค่าคงที่: 2 ครั้ง (0x00000002)

AD_EVENT_TYPE_WIN

เพิ่มใน Android UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_WIN

ระบบจะสร้างประเภทเหตุการณ์โฆษณา WIN โดยอัตโนมัติภายในบริการ Protected Audience สําหรับ โฆษณาที่ชนะซึ่งส่งกลับมาจากการเลือกโฆษณา Protected Audience

ไม่ควรใช้ในการอัปเดตฮิสโตแกรมตัวนับโฆษณาด้วยตนเอง

มูลค่าคงที่: 0 ครั้ง (0x00000000)

ช่อง

ครีเอเตอร์

เพิ่มใน Android UpsideDownCakePrivacySandbox 
public static final Creator<FrequencyCapFilters> CREATOR

วิธีการสาธารณะ

เท่ากับ

public boolean equals (Object o)

ตรวจสอบว่าออบเจ็กต์ FrequencyCapFilters มีข้อมูลเดียวกันหรือไม่

พารามิเตอร์
o Object: ออบเจ็กต์อ้างอิงที่จะใช้เปรียบเทียบ
คิกรีเทิร์น
boolean true หากวัตถุนี้เหมือนกับ obj ข้อโต้แย้ง; false หรือไม่เช่นนั้น

getKeyedFrequencyCapsForClickEvent

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_CLICK

ความถี่สูงสุดเหล่านี้ใช้กับเหตุการณ์ที่เกี่ยวข้องกับการคลิกตามที่ตีความ AdTech ระบบจะนับกิจกรรมการคลิกเมื่อมีการเรียกใช้ AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) API ด้วยประเภทเหตุการณ์ AD_EVENT_TYPE_CLICK

คิกรีเทิร์น
List<KeyedFrequencyCap> ค่านี้ต้องไม่เป็น null

getKeyedFrequencyCapsForimpressionsEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_IMPRESSION

ความถี่สูงสุดเหล่านี้ใช้กับเหตุการณ์ที่สัมพันธ์กับการแสดงผลซึ่งตีความโดย AdTech

โปรดทราบว่าระบบจะไม่นับเหตุการณ์โดยอัตโนมัติเมื่อโทรหา AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver) แต่ประเภทเหตุการณ์ AD_EVENT_TYPE_IMPRESSION จะต้อง โดยใช้ AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) API

คิกรีเทิร์น
List<KeyedFrequencyCap> ค่านี้ต้องไม่เป็น null

getKeyedFrequencyCapsForViewเหตุการณ์

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_VIEW

ความถี่สูงสุดเหล่านี้ใช้กับเหตุการณ์ที่เกี่ยวข้องกับการดูตามที่ตีความโดย AdTech ระบบจะนับเหตุการณ์การดูเมื่อมีการเรียกใช้ AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) API ด้วยเหตุการณ์ประเภท AD_EVENT_TYPE_VIEW

คิกรีเทิร์น
List<KeyedFrequencyCap> ค่านี้ต้องไม่เป็น null

getKeyedFrequencyCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

รับรายการออบเจ็กต์ KeyedFrequencyCap รายการที่จะกรองประเภทเหตุการณ์ AD_EVENT_TYPE_WIN

ความถี่สูงสุดเหล่านี้ใช้กับเหตุการณ์สำหรับโฆษณาที่เลือกเป็นผู้ชนะในโฆษณา มากมาย โฆษณาที่ชนะจะใช้เพื่อเพิ่มคีย์ตัวนับที่เกี่ยวข้องบน ชนะประเภทเหตุการณ์

โปรดทราบว่าคุณอัปเดตประเภทเหตุการณ์ AD_EVENT_TYPE_WIN ด้วยตนเองไม่ได้โดยใช้ API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver)

คิกรีเทิร์น
List<KeyedFrequencyCap> ค่านี้ต้องไม่เป็น null

แฮชโค้ด

public int hashCode ()

แสดงผลแฮชของข้อมูลของออบเจ็กต์ FrequencyCapFilters

คิกรีเทิร์น
int ค่าแฮชโค้ดสำหรับออบเจ็กต์นี้

toString

public String toString ()

แสดงผลตัวแทนสตริงของออบเจ็กต์ โดยทั่วไปแล้ว เมธอด toString แสดงผลสตริงที่ "แสดงข้อความแทน" เป็นออบเจ็กต์นี้ ผลลัพธ์ที่ได้ควร เป็นการนำเสนอที่กระชับแต่ให้ข้อมูล ซึ่งง่ายสำหรับ ให้อ่าน ขอแนะนำให้คลาสย่อยทั้งหมดลบล้างเมธอดนี้

เมธอด toString สำหรับชั้นเรียน Object จะแสดงผลสตริงที่ประกอบด้วยชื่อของคลาสที่มีฟังก์ชัน เป็นอินสแตนซ์ อักขระเครื่องหมาย `@' และ เลขฐานสิบหกที่ไม่มีเครื่องหมายของแฮชโค้ด ออบเจ็กต์ กล่าวอีกนัยหนึ่งคือ เมธอดนี้จะแสดงสตริงที่มีค่าเท่ากับ ค่าของ: 

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

คิกรีเทิร์น
String ตัวแทนสตริงของออบเจ็กต์

เขียนถึงพาร์เซล

public void writeToParcel (Parcel dest, 
                int flags)

แยกวัตถุนี้ลงในแปลงที่ดิน

พารามิเตอร์
dest Parcel: ค่านี้ต้องไม่เป็น null
flags int: แฟล็กเพิ่มเติมเกี่ยวกับวิธีเขียนออบเจ็กต์ อาจเป็น 0 หรือ Parcelable.PARCELABLE_WRITE_RETURN_VALUE ค่าเป็น 0 หรือชุดค่าผสมของ Parcelable.PARCELABLE_WRITE_RETURN_VALUE และ android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES