بيانات الإعلان

public final class AdData
extends Object implements Parcelable

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

تمثّل هذه السمة بيانات خاصة بإعلان تكون ضرورية لاختيار الإعلان وعرضه.

ملخّص

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

class AdData.Builder

أداة إنشاء AdData عنصر 

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

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<AdData> CREATOR

الطرق العامة

boolean equals(Object o)

تتحقّق مما إذا كان كائنان AdData يحتويان على المعلومات نفسها.

Set<Integer> getAdCounterKeys()

للحصول على مجموعة المفاتيح المستخدمة في عدّ الأحداث.

AdFilters getAdFilters()

ربط جميع AdFilters بالإعلان.

String getAdRenderId()

الحصول على رقم تعريف عرض الإعلان لمزادات الخوادم

String getMetadata()

الحصول على البيانات الوصفية لإعلانات المشتري المستخدمة أثناء عملية اختيار الإعلانات

Uri getRenderUri()

يحصل على معرّف الموارد المنتظم (URI) الذي يشير إلى مواد عرض عرض الإعلان.

int hashCode()

تعرض تجزئة بيانات عنصر AdData.

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)

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

الحقول

صانع محتوى

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4 
public static final Creator<AdData> CREATOR

الطرق العامة

علامة يساوي

public boolean equals (Object o)

تتحقّق مما إذا كان كائنان AdData يحتويان على المعلومات نفسها.

المعلمات
o Object: الكائن المرجعي المطلوب المقارنة معه
المرتجعات
boolean true إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ false بخلاف ذلك.

الحصول على مفاتيح عدّاد الإعلانات

public Set<Integer> getAdCounterKeys ()

للحصول على مجموعة المفاتيح المستخدمة في عدّ الأحداث.

لا يجوز ربط أكثر من 10 مفاتيح لعدّاد الإعلانات بالإعلان.

تُستخدَم المفاتيح والأرقام لكل مفتاح في فلترة تحديد عدد مرات الظهور أثناء اختيار الإعلان استبعاد الإعلانات المرتبطة من الإرسال إلى عروض الأسعار

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

المرتجعات
Set<Integer> لا يمكن أن تكون هذه القيمة null.

الحصول على فلاتر الإعلانات

public AdFilters getAdFilters ()

ربط جميع AdFilters بالإعلان.

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

المرتجعات
AdFilters

معرّف getAdRenderId

public String getAdRenderId ()

الحصول على رقم تعريف عرض الإعلان لمزادات الخوادم

يتم جمع رقم تعريف عرض الإعلان لكل AdData عند تلقّي طلب المزاد من الخادم.

لن تكون أي AdData لا تحتوي على معرّف عرض الإعلان مؤهلة للمزاد من جهة الخادم.

المرتجعات
String قد تكون هذه القيمة null.

الحصول على البيانات الوصفية

public String getMetadata ()

الحصول على البيانات الوصفية لإعلانات المشتري المستخدمة أثناء عملية اختيار الإعلانات

يجب أن تكون البيانات الوصفية كائن JSON صالحًا مُتسلسلاً كسلسلة. تمثل بيانات التعريف معلومات عروض الأسعار المتعلقة بالإعلانات التي سيتم استخدامها أثناء اختيار الإعلان كجزء من عرض السعر يتم إنشاؤها واستخدامها في منطق JavaScript للمشتري، حيث يتم تنفيذها في عملية تنفيذ منفصلة محددة.

إذا لم تكن البيانات الوصفية عنصر JSON صالحًا يمكن استخدامه بواسطة JavaScript للمشتري، سيتم لن يكون مؤهلاً لاختيار الإعلانات.

المرتجعات
String لا يمكن أن تكون هذه القيمة null.

الحصول على RenderUri

public Uri getRenderUri ()

يحصل على معرّف الموارد المنتظم (URI) الذي يشير إلى مواد عرض عرض الإعلان. يجب أن يستخدم معرِّف الموارد المنتظم (URI) بروتوكول HTTPS.

المرتجعات
Uri لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

تعرض تجزئة بيانات عنصر AdData.

المرتجعات
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