فلاتر معدل التكرار
public
final
class
FrequencyCapFilters
extends Object
implements
Parcelable
| java.lang.Object | |
| ↳ | android.adservices.common.ترددCapFilters |
حاوية لفلاتر الإعلانات التي تستند إلى تحديد عدد مرات الظهور.
لا يجوز ربط أكثر من 20 فلترًا لتحديد عدد مرات الظهور بإعلان واحد.
تجمع فلاتر تحديد عدد مرات الظهور بين نوع حدث وقائمة من عناصر KeyedFrequencyCap
لتحديد مجموعة من فلاتر الإعلانات. وإذا تم تجاوز أي من قيم تحديد عدد مرات الظهور لإعلان معيّن،
ستتم إزالة الإعلان من مجموعة الإعلانات المرسَلة إلى وظيفة عروض الأسعار في تقنية إعلان المشتري.
ملخّص
الصفوف المتداخلة | |
|---|---|
class |
FrequencyCapFilters.Builder
أداة إنشاء لإنشاء عناصر |
الثوابت | |
|---|---|
int |
AD_EVENT_TYPE_CLICK
|
int |
AD_EVENT_TYPE_IMPRESSION
|
int |
AD_EVENT_TYPE_VIEW
|
int |
AD_EVENT_TYPE_WIN
تتم تعبئة نوع حدث الإعلان WIN تلقائيًا ضمن خدمة "الجمهور المحمي" لأي إعلان فائز يتم عرضه من مجموعة إعلانات "الجمهور المحمي". |
الثوابت المكتسَبة |
|---|
الحقول | |
|---|---|
public
static
final
Creator<FrequencyCapFilters> |
CREATOR
|
الطرق المتاحة للجميع | |
|---|---|
boolean
|
equals(Object o)
للتحقّق مما إذا كانت عناصر |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForClickEvents()
للحصول على قائمة بكائنات |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForImpressionEvents()
للحصول على قائمة بكائنات |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForViewEvents()
للحصول على قائمة بكائنات |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForWinEvents()
للحصول على قائمة بكائنات |
int
|
hashCode()
لعرض تجزئة بيانات الكائن |
String
|
toString()
لعرض تمثيل سلسلة للكائن. |
void
|
writeToParcel(Parcel dest, int flags)
انقِل هذا العنصر إلى طرد. |
الطرق المكتسبة | |
|---|---|
الثوابت
حدث AD_EVENT_TYPE_نقرة
public static final int AD_EVENT_TYPE_CLICK
القيمة الثابتة: 3 (0x00000003)
حدث AD_EVENT_TYPE_IMPRESSION
public static final int AD_EVENT_TYPE_IMPRESSION
القيمة الثابتة: 1 (0x00000001)
عرض AD_EVENT_TYPE_VIEW
public static final int AD_EVENT_TYPE_VIEW
القيمة الثابتة: 2 (0x00000002)
حدث AD_EVENT_TYPE_WIN
public static final int AD_EVENT_TYPE_WIN
تتم تعبئة نوع حدث الإعلان WIN تلقائيًا ضمن خدمة "الجمهور المحمي" لأي إعلان فائز يتم عرضه من مجموعة إعلانات "الجمهور المحمي".
ولا ينبغي استخدامه لتعديل المدرّج التكراري لعدّاد الإعلانات يدويًا.
القيمة الثابتة: 0 (0x00000000)
الحقول
صانع محتوى
public static final Creator<FrequencyCapFilters> CREATOR
الطرق المتاحة للجميع
علامة يساوي
public boolean equals (Object o)
للتحقّق مما إذا كانت عناصر FrequencyCapFilters تحتوي على المعلومات نفسها.
| المعلّمات | |
|---|---|
o |
Object: الكائن المرجعي المطلوب مقارنته. |
| الركلات المردودة | |
|---|---|
boolean |
true إذا كان هذا الكائن مطابقًا للوسيطة obj، وبخلاف ذلك false. |
getKeyedFrequencyCapsForClickEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()
للحصول على قائمة بكائنات KeyedFrequencyCap التي ستتم فلترتها حسب نوع الحدث AD_EVENT_TYPE_CLICK.
وينطبق تحديد عدد مرات الظهور هذا على الأحداث المرتبطة بنقرة معيّنة كما تفسرها
إحدى أدوات تكنولوجيا الإعلان. يتم احتساب أحداث النقر عند استدعاء واجهة برمجة التطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) من خلال نوع الحدث AD_EVENT_TYPE_CLICK.
| الركلات المردودة | |
|---|---|
List<KeyedFrequencyCap> |
لا يمكن أن تكون هذه القيمة null. |
getKeyedترددCapsForimpressionEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()
للحصول على قائمة بكائنات KeyedFrequencyCap التي ستتم فلترتها حسب نوع الحدث AD_EVENT_TYPE_IMPRESSION.
وينطبق تحديد عدد مرات الظهور هذا على الأحداث التي ترتبط بمرة ظهور وفقًا لما تفسره إحدى أدوات تكنولوجيا الإعلان.
لاحظ أنه لا يتم احتساب الأحداث تلقائيًا عند الاتصال بـ AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver). بدلاً من ذلك، يجب تعديل نوع الحدث AD_EVENT_TYPE_IMPRESSION
باستخدام واجهة برمجة التطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).
| الركلات المردودة | |
|---|---|
List<KeyedFrequencyCap> |
لا يمكن أن تكون هذه القيمة null. |
getKeyedترددCapsForViewEvents
public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()
للحصول على قائمة بكائنات KeyedFrequencyCap التي ستتم فلترتها حسب نوع الحدث AD_EVENT_TYPE_VIEW.
ينطبق تحديد عدد مرات الظهور هذا على الأحداث المرتبطة بمشاهدة معيّنة حسب ما تم تفسيره من خلال
تقنية إعلان. يتم احتساب أحداث المشاهدة عند استدعاء واجهة برمجة التطبيقات AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) API مع نوع الحدث AD_EVENT_TYPE_VIEW.
| الركلات المردودة | |
|---|---|
List<KeyedFrequencyCap> |
لا يمكن أن تكون هذه القيمة null. |
getKeyedترددCapsForWinEvents
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 |
تمثيل سلسلة للكائن. |
الكتابة إلىParcel
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 |