تحديث AdCounterHistogramRequest
public
class
UpdateAdCounterHistogramRequest
extends Object
java.lang.Object | |
↳ | android.adservices.adsselect.UpdateAdCounterHistogramRequest |
طلب كائن يضم الوسيطات المطلوبة واللازمة لتحديث المدرج التكراري لعداد الإعلان.
تُستخدَم المدرّجات التكرارية لعدّاد الإعلانات، وهي سجلات سابقة للأحداث المرتبطة بمفتاح عدّاد الإعلان ونوع حدث الإعلان، لإبلاغ فلترة تحديد عدد مرّات الظهور عند استخدام Protected Audience API.
ملخّص
الصفوف المتداخلة | |
---|---|
class |
UpdateAdCounterHistogramRequest.Builder
أداة إنشاء لـ |
الطرق المتاحة للجميع | |
---|---|
boolean
|
equals(Object o)
للتحقّق مما إذا كانت عناصر |
int
|
getAdEventType()
للحصول على نوع حدث الإعلان الذي يحدد المدرّج التكراري الذي يجب تعديله، بالإضافة إلى مفاتيح عدّاد الإعلان. |
long
|
getAdSelectionId()
للحصول على رقم تعريف اختيار الإعلان الذي ترتبط به أحداث الإعلان المعروض. |
AdTechIdentifier
|
getCallerAdTech()
للحصول على |
int
|
hashCode()
لعرض تجزئة بيانات الكائن |
String
|
toString()
لعرض تمثيل سلسلة للكائن. |
الطرق المكتسبة | |
---|---|
الطرق المتاحة للجميع
علامة يساوي
public boolean equals (Object o)
للتحقّق مما إذا كانت عناصر UpdateAdCounterHistogramRequest
تحتوي على المعلومات نفسها.
المعلّمات | |
---|---|
o |
Object : الكائن المرجعي المطلوب مقارنته. |
الركلات المردودة | |
---|---|
boolean |
true إذا كان هذا الكائن مطابقًا للوسيطة obj، وبخلاف ذلك false . |
getAdEventType
public int getAdEventType ()
للحصول على نوع حدث الإعلان الذي يحدد المدرّج التكراري الذي يجب تعديله، بالإضافة إلى مفاتيح عدّاد الإعلان.
الركلات المردودة | |
---|---|
int |
القيمة هي android.adservices.common.BudgetCapFilters.AD_EVENT_TYPE_INVALID أو FrequencyCapFilters.AD_EVENT_TYPE_WIN أو FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION أو FrequencyCapFilters.AD_EVENT_TYPE_VIEW أو FrequencyCapFilters.AD_EVENT_TYPE_CLICK أو android.adservices.common.FeedbackCapFilters.AD_EVENT_TYPE_MIN أو android.adservices.common.ترددCapFilters.AD_EVENT_TYPE_MAX |
getAdSelectionId
public long getAdSelectionId ()
للحصول على رقم تعريف اختيار الإعلان الذي ترتبط به أحداث الإعلان المعروض.
لمزيد من المعلومات عن رقم تعريف اختيار الإعلان، اطّلِع على AdSelectionOutcome
.
يجب أن يكون الإعلان قد تم اختياره من اختيار الإعلانات للجمهور المحمي في آخر 24 ساعة، ويجب أن يكون قد تم بدء طلب اختيار الإعلان من التطبيق نفسه مثل تطبيق الاتصال الحالي. سيتم تعديل المدرجات التكرارية للأحداث لكل مفاتيح عدّاد الإعلانات المرتبطة بالإعلان المحدد في معرّف اختيار الإعلان حسب نوع حدث الإعلان من getAdEventType()
، ليتم استخدامها في فلترة تحديد عدد مرات الظهور للجمهور المحمي.
الركلات المردودة | |
---|---|
long |
getCallerAdTech
public AdTechIdentifier getCallerAdTech ()
للحصول على AdTechIdentifier
التابع لكيان adtech (المتصل).
يجب أن تكون تكنولوجيا الإعلان التي تستخدِم عنصر UpdateAdCounterHistogramRequest
مسجَّلاً
في "مبادرة حماية الخصوصية" وأن يُسمح لها بالتصرف نيابةً عن تطبيق الاتصال. وليس من الضروري أن تكون
تكنولوجيا الإعلان المحدّدة هي نفسها تكنولوجيا الإعلان مثل المشتري الذي يملك الإعلان المعروض
أو البائع الذي بدأ اختيار الإعلان المرتبط برقم التعريف الذي تم إرجاعه من خلال getAdSelectionId()
.
لمزيد من المعلومات حول متطلبات واستثناءات واجهة برمجة التطبيقات، يمكنك الاطّلاع على AdSelectionManager.updateAdCounterHistogram(android.adservices.adselection.UpdateAdCounterHistogramRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver)
.
الركلات المردودة | |
---|---|
AdTechIdentifier |
لا يمكن أن تكون هذه القيمة null . |
رمز التجزئة
public int hashCode ()
لعرض تجزئة بيانات الكائن UpdateAdCounterHistogramRequest
.
الركلات المردودة | |
---|---|
int |
قيمة رمز تجزئة لهذا الكائن. |
سلسلة
public String toString ()
لعرض تمثيل سلسلة للكائن. وبشكل عام، تعرض الطريقة toString
سلسلة "تمثل نصيًا" لهذا الكائن. ويجب أن تكون النتيجة عبارة عن وصف موجز وغني بالمعلومات يسهل على المستخدم قراءته.
من المستحسن أن تلغي جميع الفئات الفرعية هذه الطريقة.
تعرض الطريقة toString
للفئة Object
سلسلة تتكون من اسم الفئة التي يكون الكائن فيها مثيلاً، وحرف العلامة "@
"، والتمثيل السداسي العشري غير الموقَّع لرمز تجزئة
الكائن. بمعنى آخر، تُرجع هذه الطريقة سلسلة تساوي قيمة:
getClass().getName() + '@' + Integer.toHexString(hashCode())
الركلات المردودة | |
---|---|
String |
تمثيل سلسلة للكائن. |