تحديد معدل التردد الرئيسي
public
final
class
KeyedFrequencyCap
extends Object
implements
Parcelable
| java.lang.Object | |
| ↳ | android.adservices.common.KeyedGoalCap |
تحديد عدد مرات الظهور لمفتاح عدّاد إعلان معيّن.
يحدد عدد مرات الظهور الحد الأقصى لمعدل وقوع الحدث خلال فترة زمنية معينة. في حال تجاوز عدد مرات الظهور، ستتم فلترة الإعلان المرتبط من مجموعة الإعلانات المحدّدة.
ملخّص
الصفوف المتداخلة | |
|---|---|
class |
KeyedFrequencyCap.Builder
أداة إنشاء لإنشاء عناصر |
الثوابت المكتسَبة |
|---|
الحقول | |
|---|---|
public
static
final
Creator<KeyedFrequencyCap> |
CREATOR
|
الطرق المتاحة للجميع | |
|---|---|
boolean
|
equals(Object o)
للتحقّق مما إذا كانت عناصر |
int
|
getAdCounterKey()
تعرض مفتاح عدّاد الإعلانات الذي تم تطبيق عدد مرات الظهور عليه. |
Duration
|
getInterval()
يتم عرض الفاصل الزمني على شكل |
int
|
getMaxCount()
لعرض الحد الأقصى لعدد مرات ورود الأحداث المسموح بها خلال فترة زمنية محددة. |
int
|
hashCode()
لعرض تجزئة بيانات الكائن |
String
|
toString()
لعرض تمثيل سلسلة للكائن. |
void
|
writeToParcel(Parcel dest, int flags)
انقِل هذا العنصر إلى طرد. |
الطرق المكتسبة | |
|---|---|
الحقول
صانع محتوى
public static final Creator<KeyedFrequencyCap> CREATOR
الطرق المتاحة للجميع
علامة يساوي
public boolean equals (Object o)
للتحقّق مما إذا كانت عناصر KeyedFrequencyCap تحتوي على المعلومات نفسها.
| المعلّمات | |
|---|---|
o |
Object: الكائن المرجعي المطلوب مقارنته. |
| الركلات المردودة | |
|---|---|
boolean |
true إذا كان هذا الكائن مطابقًا للوسيطة obj، وبخلاف ذلك false. |
getAdCounterKey
public int getAdCounterKey ()
تعرض مفتاح عدّاد الإعلانات الذي تم تطبيق عدد مرات الظهور عليه.
يتم تعريف مفتاح عدّاد الإعلانات من خلال تكنولوجيا adtech، وهو معرّف رقمي عشوائي يحدّد أي معايير ربما تم احتسابها واحتفظت بها في السابق على الجهاز. وفي حال تجاوز العدد على الجهاز الحد الأقصى المسموح به خلال فترة زمنية معيّنة، يتم تجاوز الحدّ الأقصى لعدد مرات الظهور.
| الركلات المردودة | |
|---|---|
int |
لا يمكن أن تكون هذه القيمة null. |
الحصول على فاصل زمني
public Duration getInterval ()
يتم عرض الفاصل الزمني على شكل Duration والذي سيتم اقتطاعه إلى أقرب ثانية
يتم فيها احتساب الحد الأقصى لعدد مرات الظهور.
عند احتساب عدد مرات الظهور هذا، يتم احتساب عدد الأحداث المستمرة في آخر فاصل زمني. إذا كان عدد الأحداث المطابقة التي حدثت في السابق لتقنية الإعلان أكبر من العدد الذي تعرضه getMaxCount()، يتم تجاوز الحد الأقصى لعدد مرات الظهور ولن يكون الإعلان مؤهَّلاً لاختياره.
| الركلات المردودة | |
|---|---|
Duration |
لا يمكن أن تكون هذه القيمة null. |
getMaxCount
public int getMaxCount ()
لعرض الحد الأقصى لعدد مرات ورود الأحداث المسموح بها خلال فترة زمنية محددة.
في حال احتساب المزيد من الأحداث المطابقة لمفتاح عدّاد الإعلان ونوع حدث الإعلان على الجهاز خلال الفترة الزمنية المحدّدة في getInterval()، يتم تجاوز الحدّ الأقصى لعدد مرات الظهور ولن يكون الإعلان مؤهَّلاً لاختيار الإعلان.
على سبيل المثال، لن يكون الإعلان الذي يحدِّد فلترًا لاثنين كحد أقصى خلال ساعة واحدة مؤهّلاً لاختيار الإعلان إذا تم احتساب الحدث مرتين أو أكثر خلال الساعة التي سبقت عملية اختيار الإعلان.
| الركلات المردودة | |
|---|---|
int |
|
رمز التجزئة
public int hashCode ()
لعرض تجزئة بيانات الكائن KeyedFrequencyCap.
| الركلات المردودة | |
|---|---|
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 |