تحديث AdCounterHistogramRequest

public class UpdateAdCounterHistogramRequest
extends Object

java.lang.Object
↳ android.adservices.adsselect.UpdateAdCounterHistogramRequest

طلب كائن يضم الوسيطات المطلوبة واللازمة لتحديث المدرج التكراري لعداد الإعلان.

تُستخدَم المدرّجات التكرارية لعدّاد الإعلانات، وهي سجلات سابقة للأحداث المرتبطة بمفتاح عدّاد الإعلان ونوع حدث الإعلان، لإبلاغ فلترة تحديد عدد مرّات الظهور عند استخدام Protected Audience API.

ملخّص

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

class UpdateAdCounterHistogramRequest.Builder

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

الطرق المتاحة للجميع

boolean equals(Object o)

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

int getAdEventType()

للحصول على نوع حدث الإعلان الذي يحدد المدرّج التكراري الذي يجب تعديله، بالإضافة إلى مفاتيح عدّاد الإعلان.

long getAdSelectionId()

للحصول على رقم تعريف اختيار الإعلان الذي ترتبط به أحداث الإعلان المعروض.

AdTechIdentifier getCallerAdTech()

للحصول على AdTechIdentifier التابع لكيان adtech (المتصل).

int hashCode()

لعرض تجزئة بيانات الكائن UpdateAdCounterHistogramRequest.

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 تمثيل سلسلة للكائن.