AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
↳ android.adservices.ads selectionConfig

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

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

ملخّص

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

class AdSelectionConfig.Builder

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

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

الحقول

public static final Creator<AdSelectionConfig> CREATOR

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

int describeContents()

صِف أنواع الكائنات الخاصة المضمّنة في التمثيل المنظّم في مثال 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)

انقِل هذا العنصر إلى طرد.

الطرق المكتسبة

الحقول

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

وصف المحتوى

public int describeContents ()

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

الركلات المردودة
int قناع بت يشير إلى مجموعة أنواع الكائنات الخاصة التي تم تنظيمها من خلال مثيل الكائن القابل للقطع. القيمة هي 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.

الحصول على AdSelectionSignals

public AdSelectionSignals getAdSelectionSignals ()

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

الحصول على Custom AudienceBuyers

public List<AdTechIdentifier> getCustomAudienceBuyers ()

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

الحصول على DecisionLogicUri

public Uri getDecisionLogicUri ()

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

getPerBuyerSignals

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

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

الحصول على بائع

public AdTechIdentifier getSeller ()

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

الحصول على مؤشرات البائعين

public AdSelectionSignals getSellerSignals ()

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

الحصول على TrustedScoringSignalsUri

public Uri getTrustedScoringSignalsUri ()

الركلات المردودة
Uri نقطة نهاية معرّف الموارد المنتظم (URI) لإشارة موثوق بها من جهة البيع يمكن من خلالها الحصول على معلومات محدّدة في الوقت الفعلي لتصميم الإعلان. لا يمكن أن تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

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

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

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

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

الركلات المردودة
int قيمة رمز تجزئة لهذا الكائن.

الكتابة إلى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