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

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

الثوابت المكتسَبة

int CONTENTS_FILE_DESCRIPTOR

وحدة بت الواصف المستخدمة مع describeContents(): تشير إلى أن يتضمن التمثيل المسطَّح للكائن القابل للبرمجة واصف الملف.

int PARCELABLE_WRITE_RETURN_VALUE

علامة للاستخدام مع writeToParcel(Parcel, int): الكائن الذي تتم كتابته هي القيمة المعروضة، التي هي نتيجة دالة مثل "Parcelable someFunction()", "void someFunction(out Parcelable)"، أو "void someFunction(inout Parcelable)".

الحقول

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)

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

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

Object clone()

تنشئ نسخة من هذا الكائن وتعرضها.

boolean equals(Object obj)

يشير إلى ما إذا كان هناك كائن آخر "يساوي" لهذا البرنامج.

void finalize()

يتم استدعاء هذا الإجراء من قِبل خدمة تجميع البيانات المهملة على الكائن عند جمع البيانات المهملة. إلى عدم وجود مراجع أخرى للكائن.

final Class<?> getClass()

تعرض فئة بيئة التشغيل هذه لجهاز Object.

int hashCode()

تعرض قيمة رمز التجزئة للكائن.

final void notify()

تنشيط سلسلة محادثات واحدة بانتظار وصول هذا الكائن إلى البيانات الشاشة.

final void notifyAll()

لتنشيط جميع سلاسل المحادثات التي تنتظر شاشة هذا الكائن.

String toString()

تعرض تمثيلاً سلسلة للكائن.

final void wait(long timeoutMillis, int nanos)

يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى من خلال الإشعارات أو المقاطعة، أو حتى قد انقضى قدر معين من الوقت الفعلي.

final void wait(long timeoutMillis)

يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى من خلال الإشعارات أو المقاطعة، أو حتى قد انقضى قدر معين من الوقت الفعلي.

final void wait()

يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى عن طريق الإشعارات أو المقاطعة.

abstract int describeContents()

وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم.

abstract 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