تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

الملخّص: الصفوف المُدمجة | الثوابت المُكتسَبة | الحقول | الطرق | الطرق المكتسَبة

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

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

من الواجهة android.os.Parcelable 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) عليك تسوية هذا العنصر في قطعة أرض.

الطرق المكتسَبة
من الفئة java.lang.Object 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() تؤدي هذه الطريقة إلى انتظار سلسلة المهام الحالية إلى أن يتم تنشيطها، عادةً من خلال إرسال إشعار إليها أو مقاطعتها.
من الواجهة android.os.Parcelable abstract int describeContents() يُرجى وصف أنواع العناصر الخاصة التي تتضمّنها تمثيلة marshaled لمثيل Parcelable هذا. abstract void writeToParcel(Parcel dest, int flags) اضغط على هذا الكائن لتحويله إلى قطعة أرض.

الحقول

صانع محتوى

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public static final Creator<AdSelectionConfig> CREATOR

الطرق العامة

describeContents

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

public int describeContents ()

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

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

علامة يساوي

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

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

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public AdSelectionSignals getAdSelectionSignals ()

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

getCustomAudienceBuyers

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public List<AdTechIdentifier> getCustomAudienceBuyers ()

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

الحصول على DecisionLogicUri

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public Uri getDecisionLogicUri ()

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

getPerBuyerSignals

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

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

getSeller

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4

public AdTechIdentifier getSeller ()

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

getSellerSignals

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public AdSelectionSignals getSellerSignals ()

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

getTrustedScoringSignalsUri

تمت إضافته في مستوى واجهة برمجة التطبيقات 34
وأيضاً في Ad Services Extensions 4

public Uri getTrustedScoringSignalsUri ()

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

رمز التجزئة

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

public int hashCode ()

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

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

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

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

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

writeToParcel

تمت إضافتها في المستوى 34 لواجهة برمجة التطبيقات

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