فلاتر تحديد التكرار

public final class FrequencyCapFilters
extends Object implements Parcelable

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

حاوية لفلاتر الإعلانات التي تستند إلى عدد مرات الظهور المحددة.

لا يجوز ربط أكثر من 20 فلترًا لتحديد عدد مرات الظهور بإعلان واحد.

تجمع فلاتر تحديد عدد مرات الظهور بين نوع حدث وقائمة تتضمّن KeyedFrequencyCap عناصر. لتحديد مجموعة من فلاتر الإعلانات في حال تجاوز أي من هذه القيم المحددة لعدد مرات الظهور لإعلان معيّن، ستتم إزالة الإعلان من مجموعة الإعلانات المُرسَلة إلى وظيفة عروض الأسعار في تكنولوجيا الإعلان للمشتري.

ملخّص

الصفوف المتداخلة

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)

عليك تسوية هذا العنصر في قطعة أرض.

الطرق المكتسبة

الثوابت

AD_EVENT_TYPE_نقرة

تمت الإضافة في 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)

عرض AD_EVENT_TYPE_VIEW

تمت الإضافة في 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)

الحقول

الطرق العامة

علامة يساوي

public boolean equals (Object o)

يتحقّق مما إذا كانت عناصر FrequencyCapFilters تحتوي على المعلومات نفسها.

المعلمات
o Object: الكائن المرجعي المطلوب المقارنة معه
المرتجعات
boolean true إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ false بخلاف ذلك.

getKeyedFrequencyCapsForClickالأحداث

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

الحصول على قائمة بكائنات KeyedFrequencyCap التي ستجري الفلترة حسب نوع الحدث AD_EVENT_TYPE_CLICK

تنطبق هذه الحدود القصوى لعدد مرات الظهور على الأحداث المرتبطة بنقرة على النحو الذي تم تفسيره بواسطة adtech. يتم احتساب أحداث النقر عند استدعاء واجهة برمجة التطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) باستخدام نوع الحدث AD_EVENT_TYPE_CLICK.

المرتجعات
List<KeyedFrequencyCap> لا يمكن أن تكون هذه القيمة null.

getKeyedFrequencyCapsFor impressions Events

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()

الحصول على قائمة بكائنات KeyedFrequencyCap التي ستجري الفلترة حسب نوع الحدث AD_EVENT_TYPE_IMPRESSION

تنطبق هذه الحدود القصوى لعدد مرات الظهور على الأحداث المرتبطة بمرة ظهور كما تم تفسيرها من خلال adtech.

يُرجى العلم أنّه لا يتم احتساب الأحداث تلقائيًا عند الاتصال بالرقم AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver). وبدلاً من ذلك، يجب أن يتضمّن نوع الحدث "AD_EVENT_TYPE_IMPRESSION" باستخدام واجهة برمجة تطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

المرتجعات
List<KeyedFrequencyCap> لا يمكن أن تكون هذه القيمة null.

getKeyedFrequencyCapsForViewEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

الحصول على قائمة بكائنات KeyedFrequencyCap التي ستجري الفلترة حسب نوع الحدث AD_EVENT_TYPE_VIEW

تنطبق هذه الحدود القصوى لعدد مرات الظهور على الأحداث المرتبطة بمشاهدة ما تم تفسيره من قِبل adtech. يتم احتساب عرض الأحداث عند استدعاء واجهة برمجة التطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) باستخدام نوع الحدث AD_EVENT_TYPE_VIEW.

المرتجعات
List<KeyedFrequencyCap> لا يمكن أن تكون هذه القيمة null.

getKeyedFrequencyCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

الحصول على قائمة بكائنات KeyedFrequencyCap التي ستجري الفلترة حسب نوع الحدث AD_EVENT_TYPE_WIN

تنطبق هذه الحدود القصوى لعدد مرات الظهور على أحداث الإعلانات التي تم اختيارها كفائزين في الإعلان. التحديد. تُستخدم الإعلانات الفائزة لزيادة مفاتيح العدّاد المرتبطة تلقائيًا في نوع حدث الفوز.

تجدر الإشارة إلى أنّه لا يمكن تعديل نوع حدث AD_EVENT_TYPE_WIN يدويًا باستخدام واجهة برمجة التطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

المرتجعات
List<KeyedFrequencyCap> لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

تعرض تجزئة بيانات عنصر FrequencyCapFilters.

المرتجعات
int قيمة رمز التجزئة لهذا الكائن.

إلىسلسلة

public String toString ()

تعرض تمثيلاً سلسلة للكائن. بشكل عام، تُرجع طريقة toString سلسلة "يمثل نصيًا" لهذا الكائن. يجب أن تكون النتيجة أن يكون تمثيلاً موجزًا وغنيًا بالمعلومات ويسهل على الشخص المراد قراءته. من المستحسن أن تتجاهل جميع الفئات الفرعية هذه الطريقة.

استخدام الطريقة toString للفئة Object تُنتج سلسلة تتكون من اسم الفئة التي هو مثيل، فإن حرف علامة @ `@'، التمثيل السداسي العشري غير الموقع لرمز التجزئة الخاص بك. بعبارة أخرى، تُرجع هذه الطريقة سلسلة تساوي قيمة: 

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

المرتجعات
String تمثيل سلسلة للكائن.

كتابة ToParcel

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