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

public final class KeyedFrequencyCap
extends Object implements Parcelable

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

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

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

ملخّص

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

class KeyedFrequencyCap.Builder

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

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

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<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)

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

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

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)

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

الحقول

الطرق العامة

علامة يساوي

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