تحديد عدد مرات الظهور الرئيسي

public final class KeyedFrequencyCap
extends Object implements Parcelable

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

تحديد عدد مرات الظهور لمفتاح عدّاد إعلانات محدَّد.

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

ملخّص

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

class KeyedFrequencyCap.Builder

أداة إنشاء لإنشاء KeyedFrequencyCap عناصر 

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

الحقول

public static final Creator<KeyedFrequencyCap> CREATOR

الطرق العامة

boolean equals(Object o)

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

int getAdCounterKey()

تعرض مفتاح عدّاد الإعلانات الذي تمّ تطبيق تحديد عدد مرّات الظهور عليه.

Duration getInterval()

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

int getMaxCount()

عرض الحد الأقصى لعدد مرات تكرار الأحداث المسموح بها خلال فترة زمنية معيّنة.

int hashCode()

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

String toString()

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

void writeToParcel(Parcel dest, int flags)

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

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

الحقول

الطرق العامة

علامة يساوي

public boolean equals (Object o)

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

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

مفتاح getAdCounter

public int getAdCounterKey ()

تعرض مفتاح عدّاد الإعلانات الذي تمّ تطبيق تحديد عدد مرّات الظهور عليه.

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

المرتجعات
int لا يمكن أن تكون هذه القيمة null.

الحصول على فاصل زمني

public Duration getInterval ()

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

عند احتساب تحديد عدد مرات الظهور هذا، يتم احتساب عدد الأحداث المستمرة الفاصل الزمني الأخير. إذا كان عدد الأحداث المتطابقة التي تحدث سابقًا لتقنية إعلان أكبر من الرقم الذي يعرضه getMaxCount()، تمّ تحديد عدد مرات الظهور تجاوزها، ولن يكون الإعلان مؤهلاً لاختياره.

المرتجعات
Duration لا يمكن أن تكون هذه القيمة null.

الحصول على MaxCount

public int getMaxCount ()

عرض الحد الأقصى لعدد مرات تكرار الأحداث المسموح بها خلال فترة زمنية معيّنة.

إذا كان هناك المزيد من الأحداث التي تتطابق مع مفتاح عدّاد الإعلانات ونوع حدث الإعلان استنادًا إلى الجهاز خلال الفاصل الزمني المحدد في getInterval()، تم تحديد عدد مرات الظهور تجاوزها، ولن يكون الإعلان مؤهلاً لاختياره.

على سبيل المثال، لن يكون الإعلان الذي يحدد فلترًا للعدد الأقصى من اثنين خلال ساعة واحدة تكون مؤهَّلة لاختيار الإعلان إذا تم احتساب الحدث مرتين أو أكثر خلال الساعة. التي تسبق عملية اختيار الإعلان.

المرتجعات
int

رمز التجزئة

public int hashCode ()

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

المرتجعات
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