AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionConfig

يحتوي على إعدادات عملية اختيار الإعلانات.

يتم إنشاء نُسخ من هذه الفئة بواسطة حِزم تطوير البرامج (SDK) لتقديمها كوسيطات لطريقتَي AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) وAdSelectionManager#reportImpression في AdSelectionManager.

ملخّص

الفئات المُدمجة

class AdSelectionConfig.Builder

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

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

int CONTENTS_FILE_DESCRIPTOR

بت الوصف المستخدَم مع describeContents(): يشير إلى أنّه يتضمّن التمثيل المسطّح لعنصر Parcelable وصفًا للملف.

int PARCELABLE_WRITE_RETURN_VALUE

الإبلاغ عن استخدام writeToParcel(Parcel, int): العنصر الذي يتم كتابته هو قيمة معروضة، أي نتيجة دالة مثل "Parcelable someFunction()" أو "void someFunction(out Parcelable)" أو "void someFunction(inout Parcelable)".

الحقول

public static final Creator<AdSelectionConfig> CREATOR

الطرق العامة

int describeContents()

يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا.

boolean equals(Object o)

يشير إلى ما إذا كان هناك عنصر آخر "مساوٍ" لهذا العنصر.

AdSelectionSignals getAdSelectionSignals()
List<AdTechIdentifier> getCustomAudienceBuyers()
Uri getDecisionLogicUri()
Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals()
AdTechIdentifier getSeller()
AdSelectionSignals getSellerSignals()
Uri getTrustedScoringSignalsUri()
int hashCode()

عرض قيمة رمز التجزئة للعنصر

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()

يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا.

abstract void writeToParcel(Parcel dest, int flags)

اضغط على هذا الكائن لتحويله إلى قطعة أرض.

الحقول

صانع محتوى

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4 
public static final Creator<AdSelectionConfig> CREATOR

الطرق العامة

describeContents

public int describeContents ()

صِف أنواع العناصر الخاصة المضمّنة في التمثيل المنظّم لهذه المثيل القابل للقطع. على سبيل المثال، إذا كان العنصر سيتضمّن وصف ملف في ناتج writeToParcel(android.os.Parcel, int)، يجب أن تتضمّن القيمة المعروضة من هذه الطريقة البت CONTENTS_FILE_DESCRIPTOR.

المرتجعات
int قناع بت يشير إلى مجموعة أنواع الكائنات الخاصة التي تم تجميعها بواسطة مثيل كائن Parcelable هذا. القيمة هي 0 أو CONTENTS_FILE_DESCRIPTOR

علامة يساوي

public boolean equals (Object o)

يشير إلى ما إذا كان هناك عنصر آخر "مساوٍ" لهذا العنصر.

تنفِّذ طريقة equals علاقة تكافؤ على مراجع الكائنات غير الصفرية:

  • وهي عاكسة: لأي قيمة مرجعية غير خالية x، يجب أن تعرض x.equals(x) true.
  • وهي متماثلة: بالنسبة إلى أي قيم مرجعية غير صفرية x وy، يجب أن تعرِض x.equals(y) القيمة true إذا كانت y.equals(x) تعرِض القيمة true فقط.
  • وهي تدرّجية: بالنسبة إلى أي قيم مرجعية غير صفرية x وy وz، إذا كانت x.equals(y) تعرِض true و y.equals(z) تعرِض true، عندئذٍ x.equals(z) يجب أن تعرِض true.
  • متسقة: بالنسبة إلى أي قيم مرجعية غير فارغة x وy، تعرض الاستدعاءات المتعددة للسمة x.equals(y) true باستمرار أو تعرض false باستمرار، بشرط عدم استخدام أي معلومات في مقارنات equals حول العناصر.
  • بالنسبة إلى أي قيمة مرجعية غير فارغة x، x.equals(null) يجب أن تعرض false.

تُنفِّذ طريقة equals لفئة Object علاقة التكافؤ الأكثر تمييزًا على العناصر، أي أنّه بالنسبة إلى أي قيم مرجعية غير فارغة x و y، تعرض هذه الطريقة القيمة true إذا كانت x وy تشير إلى العنصر نفسه (x == y لها القيمة true).

يُرجى العِلم أنّه من الضروري بشكل عام إلغاء طريقة hashCode عند إلغاء هذه الطريقة، وذلك للحفاظ على العقد العام لطريقة hashCode، الذي ينص على أنّه يجب أن تتضمّن العناصر المتساوية رموز تجزئة متساوية.

المعلمات
o ‫Object: العنصر المرجعي الذي تتم المقارنة به
المرتجعات
boolean true إذا كان هذا الكائن مطابقًا لوسيطة obj، وfalse في الحالات الأخرى

getAdSelectionSignals

public AdSelectionSignals getAdSelectionSignals ()

المرتجعات
AdSelectionSignals يمثّل تنسيق JSON في عنصر AdSelectionSignals، الذي يتم استرجاعه من AdSelectionConfig واستهلاكه بواسطة منطق JS الذي يتم استرجاعه من منصّة DSP، الإشارات المقدَّمة للمشترين المشارِكين في عمليات اختيار الإعلانات وإعداد التقارير. لا يمكن أن تكون هذه القيمة null.

getCustomAudienceBuyers

public List<AdTechIdentifier> getCustomAudienceBuyers ()

المرتجعات
List<AdTechIdentifier> قائمة بمشتري شرائح الجمهور المخصّصة الذين يسمح لهم نظام SSP بالمشاركة في عملية اختيار الإعلانات لا يمكن أن تكون هذه القيمة null.

الحصول على DecisionLogicUri

public Uri getDecisionLogicUri ()

المرتجعات
Uri معرّف الموارد المنتظم (URI) المستخدم لاسترداد رمز JavaScript الذي يحتوي على وظيفة البائع/SSP ScoreAd المستخدمة أثناء اختيار الإعلانات وعمليات إعداد التقارير لا يمكن أن تكون هذه القيمة null.

getPerBuyerSignals

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

المرتجعات
Map<AdTechIdentifier, AdSelectionSignals> خريطة للمشترين و"إشارات اختيار الإعلانات"، يتم جلبها من AdSelectionConfig و يتم استخدامها من خلال منطق JS الذي يتم جلبه من وحدة معالجة الإحالات الناجحة، والتي تمثّل أي معلومات يقدّمها كل مشتري أثناء اختيار الإعلان للمشاركين (مثل الحدّ الأدنى لعروض الأسعار ونوع اختيار الإعلان وما إلى ذلك) لا يمكن أن تكون هذه القيمة null.

getSeller

public AdTechIdentifier getSeller ()

المرتجعات
AdTechIdentifier معرّف AdTech للبائع، على سبيل المثال "www.example-ssp.com" لا يمكن أن تكون هذه القيمة null.

getSellerSignals

public AdSelectionSignals getSellerSignals ()

المرتجعات
AdSelectionSignals يمثّل تنسيق JSON في عنصر AdSelectionSignals، الذي تقدّمه منصّة SSP ويستهلكه منطق JS الذي يتم استرجاعه من منصّة SSP، أي معلومات استخدمتها منصّة SSP في عملية تقييم الإعلانات لتعديل نتائج عملية اختيار الإعلانات (مثل عمليات فحص أمان العلامة التجارية والإعلانات السياقية المستبعَدة). لا يمكن أن تكون هذه القيمة null.

getTrustedScoringSignalsUri

public Uri getTrustedScoringSignalsUri ()

المرتجعات
Uri نقطة نهاية عنوان URL للإشارة الموثوق بها من جهة البيع التي يمكن من خلالها جلب معلومات في الوقت الفعلي خاصة بتصميم الإعلان. لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

عرض قيمة رمز التجزئة للعنصر تتوفّر هذه الطريقة لفائدة جداول التجزئة، مثل تلك التي يوفّرها HashMap.

العقد العام لشركة "hashCode" هو:

  • عند استدعاء الأسلوب hashCode على العنصر نفسه أكثر من مرة أثناء تنفيذ تطبيق Java، يجب أن يعرض الأسلوب hashCode باستمرارً عددًا صحيحًا مماثلاً، شرط عدم تعديل أي معلومات مستخدَمة في مقارنات equals على العنصر. لا يلزم أن يظل هذا العدد الصحيح ثابتًا من عملية تنفيذ واحدة إلى عملية تنفيذ أخرى للتطبيق نفسه.
  • إذا كان الجسمان متساويين وفقًا للطريقة equals(Object) ، يجب أن يؤدي استدعاء الطريقة hashCode على كل من الجسمَين إلى النتيجة الصحيحة نفسها.
  • ليس مطلوبًا أن يؤدي استدعاء الأسلوب hashCode على كل من العنصرين إلى نتائج صحيحة مختلفة إذا كان العنصران غير متساويين وفقًا للأسلوب equals(java.lang.Object). ويجب أن يكون المبرمج على عِلم بأنّ إنشاء نتائج أعداد صحيحة مميّزة للكائنات غير المتساوية قد يؤدي إلى تحسين أداء جداول التجزئة.

تُعرِض طريقة hashCode المحدَّدة من خلال الفئة Object أعدادًا صحيحة مختلفة للعناصر المختلفة، وذلك قدر الإمكان. (قد يتم تنفيذ hashCode أو لا يتم تنفيذه كبعض وظائف عنوان ذاكرة العنصر في وقت معيّن ).

المرتجعات
int قيمة رمز التجزئة لهذا العنصر

writeToParcel

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