بيانات الأداء الإعلاني
public
final
class
AdData
extends Object
implements
Parcelable
| java.lang.Object | |
| ↳ | android.adservices.common.AdData |
تُمثِّل البيانات الخاصة بإعلان تكون ضرورية لاختيار الإعلان وعرضه.
ملخّص
الصفوف المتداخلة | |
|---|---|
class |
AdData.Builder
أداة إنشاء لـ |
الثوابت المكتسَبة |
|---|
الحقول | |
|---|---|
public
static
final
Creator<AdData> |
CREATOR
|
الطرق المتاحة للجميع | |
|---|---|
boolean
|
equals(Object o)
للتحقّق مما إذا كان عنصرا |
Set<Integer>
|
getAdCounterKeys()
للحصول على مجموعة المفاتيح المستخدمة في حساب الأحداث. |
AdFilters
|
getAdFilters()
الحصول على كل |
String
|
getAdRenderId()
الحصول على معرّف عرض الإعلان لمزادات الخادم |
String
|
getMetadata()
الحصول على البيانات الوصفية لإعلان المشتري المستخدَمة أثناء عملية اختيار الإعلانات. |
Uri
|
getRenderUri()
الحصول على عنوان URL الذي يشير إلى مواد عرض عرض الإعلان |
int
|
hashCode()
لعرض تجزئة بيانات الكائن |
String
|
toString()
لعرض تمثيل سلسلة للكائن. |
void
|
writeToParcel(Parcel dest, int flags)
انقِل هذا العنصر إلى طرد. |
الطرق المكتسبة | |
|---|---|
الحقول
الطرق المتاحة للجميع
علامة يساوي
public boolean equals (Object o)
للتحقّق مما إذا كان عنصرا AdData يحتويان على المعلومات نفسها.
| المعلّمات | |
|---|---|
o |
Object: الكائن المرجعي المطلوب مقارنته. |
| الركلات المردودة | |
|---|---|
boolean |
true إذا كان هذا الكائن مطابقًا للوسيطة obj، وبخلاف ذلك false. |
getAdCounterKeys
public Set<Integer> getAdCounterKeys ()
للحصول على مجموعة المفاتيح المستخدمة في حساب الأحداث.
لا يجوز ربط أكثر من 10 مفاتيح عدّاد للإعلانات بإعلان معيّن.
تُستخدَم المفاتيح والأعداد لكل مفتاح في فلترة تحديد عدد مرات الظهور أثناء اختيار الإعلان من أجل استبعاد إرسال الإعلانات المرتبطة إلى عروض الأسعار.
تجدر الإشارة إلى أنّه يمكن استبدال هذه المفاتيح مع الإعلانات وبيانات عروض الأسعار الأخرى لشريحة الجمهور المخصّصة أثناء التعديل اليومي للجمهور المخصّص.
| الركلات المردودة | |
|---|---|
Set<Integer> |
لا يمكن أن تكون هذه القيمة null. |
فلاتر الإعلانات getAdFilters
public AdFilters getAdFilters ()
الحصول على كل AdFilters المرتبطة بالإعلان.
في حال استيفاء الفلاتر أو تجاوزها، ستستبعد الإعلان المرتبط من المشاركة في اختيار الإعلانات. وهذه الإعلانات اختيارية وفي حال تحديد null عدم تطبيق أيّ فلاتر على هذا الإعلان.
| الركلات المردودة | |
|---|---|
AdFilters |
|
getAdRenderId
public String getAdRenderId ()
الحصول على معرّف عرض الإعلان لمزادات الخادم
يتم جمع رقم تعريف عرض الإعلان لكل AdData عند تلقي طلب مزاد الخادم.
ولن تكون أي قيمة AdData بدون رقم تعريف لعرض الإعلان مؤهَّلة للمزاد من جهة الخادم.
| الركلات المردودة | |
|---|---|
String |
قد تكون هذه القيمة null. |
getMetadata
public String getMetadata ()
الحصول على البيانات الوصفية لإعلان المشتري المستخدَمة أثناء عملية اختيار الإعلانات.
يجب أن تكون البيانات الوصفية كائن JSON صالحًا متسلسلاً كسلسلة. وتمثِّل البيانات الوصفية معلومات عروض الأسعار الخاصة بالإعلانات التي سيتم استخدامها أثناء اختيار الإعلانات كجزء من إنشاء عروض الأسعار وتُستخدم في منطق JavaScript للمشتري، والذي يتم تنفيذه في بيئة تنفيذ معزولة.
إذا لم تكن البيانات الوصفية عنصر JSON صالحًا يمكن استخدامه من قِبل JavaScript للمشتري، لن يكون الإعلان مؤهّلاً لاختيار الإعلان.
| الركلات المردودة | |
|---|---|
String |
لا يمكن أن تكون هذه القيمة null. |
الحصول على RenderUri
public Uri getRenderUri ()
الحصول على عنوان URL الذي يشير إلى مواد عرض عرض الإعلان يجب أن يستخدم معرّف الموارد المنتظم (URI) بروتوكول HTTPS.
| الركلات المردودة | |
|---|---|
Uri |
لا يمكن أن تكون هذه القيمة null. |
رمز التجزئة
public int hashCode ()
لعرض تجزئة بيانات الكائن AdData.
| الركلات المردودة | |
|---|---|
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 |