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

ملخّص: المستخدمون | الطرق | الطرق المكتسبة

AdSelectionConfig.Builder

public static final class AdSelectionConfig.Builder
extends Object

java.lang.Object
↳	android.adservices.ads select.AdSelectionConfig.Builder

---

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

ملخّص

شركات الإنشاءات العامة
Builder()

الطرق المتاحة للجميع
AdSelectionConfig	build() لإنشاء مثيل AdSelectionConfig
AdSelectionConfig.Builder	setAdSelectionSignals(AdSelectionSignals adSelectionSignals) تحدِّد الإشارات المقدَّمة للمشترين أثناء إنشاء عروض أسعار اختيار الإعلانات.
AdSelectionConfig.Builder	setCustomAudienceBuyers(List<AdTechIdentifier> customAudienceBuyers) إعداد قائمة بالمشترين المسموح بهم
AdSelectionConfig.Builder	setDecisionLogicUri(Uri decisionLogicUri) لضبط معرّف الموارد المنتظم (URI) المستخدَم لجلب منطق القرار من أجل استخدامه في عملية اختيار الإعلانات.
AdSelectionConfig.Builder	setPerBuyerSignals(Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals) لتحديد الإشارات التي قدمها كل مشترٍ أثناء اختيار الإعلان.
AdSelectionConfig.Builder	setSeller(AdTechIdentifier seller) لضبط معرّف البائع.
AdSelectionConfig.Builder	setSellerSignals(AdSelectionSignals sellerSignals) حدِّد الإشارات المستخدَمة لتعديل نتائج اختيار الإعلانات.
AdSelectionConfig.Builder	setTrustedScoringSignalsUri(Uri trustedScoringSignalsUri) لضبط نقطة نهاية معرّف الموارد المنتظم (URI) لإشارة موثوق بها من جهة البيع، يمكن الحصول من خلالها على معلومات محدّدة في الوقت الفعلي لتصميم الإعلان.

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

من الصف 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() يؤدي إلى انتظار سلسلة المحادثات الحالية إلى أن يتم تنشيطها، وعادةً من خلال إشعارها أو مقاطعتها.

شركات الإنشاءات العامة

البنّاء

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

public Builder ()

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

إصدار

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

public AdSelectionConfig build ()

لإنشاء مثيل AdSelectionConfig

الركلات المردودة
AdSelectionConfig	لا يمكن أن تكون هذه القيمة null.

الرميات
NullPointerException	إذا كانت أي معلمات مطلوبة فارغة

setAdSelectionSignals

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

public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

تحدِّد الإشارات المقدَّمة للمشترين أثناء إنشاء عروض أسعار اختيار الإعلانات.

وفي حال تم ترك السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على JSON الفارغ.

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getAdSelectionSignals().

المعلّمات
adSelectionSignals	AdSelectionSignals: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.

setCustomAudienceBuyers

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

public AdSelectionConfig.Builder setCustomAudienceBuyers (List<AdTechIdentifier> customAudienceBuyers)

إعداد قائمة بالمشترين المسموح بهم

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getCustomAudienceBuyers().

المعلّمات
customAudienceBuyers	List: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.

setDecisionLogicUri

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

public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

لضبط معرّف الموارد المنتظم (URI) المستخدَم لجلب منطق القرار من أجل استخدامه في عملية اختيار الإعلانات. وقد يكون معرّف الموارد المنتظم (URI) للقرار أيًا من المخططَين:

• HTTPS: يجب أن تكون معرّفات الموارد المنتظمة التي تستخدم HTTPS عبارة عن معرّفات موارد منتظمة (URI) ويتطابق فيها المضيف مع seller.
• مصمّمة مسبقًا لتحديد الإعلان: تتّبِع معرّفات الموارد المنتظمة (URI) لخدمة اختيار الإعلانات تنسيق ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters>. ينشئ FLEDGE نص JS البرمجي المناسب بدون الحاجة إلى استدعاء الشبكة.

  النصوص البرمجية المتاحة التي تم إنشاؤها مسبقًا:

  • highest-bid-wins لـ scoreAds وreportResult: يختار نص JavaScript هذا الإعلان الذي قدّم أعلى عرض سعر مقابل تسجيل النقاط. لإعداد التقارير، يتضمّن معرّف الموارد المنتظم (URI) مَعلمة render_uri وbid. يجب توفّر المَعلمات التالية لاستخدام هذه الإعدادات المسبقة الإنشاء:
    • reportingUrl: معرّف الموارد المنتظم (URI) الأساسي لإعداد التقارير والذي سيتم تحديده لاحقًا مع render_uri وbid

    مثال إذا كان عنوان URL الأساسي لإعداد التقارير هو "https://www.ssp.com"، يجب ad-selection-prebuilt://ad-selection/highest-bid-wins/?reportingUrl=https://www.ssp.com.

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getDecisionLogicUri().

المعلّمات
decisionLogicUri	Uri: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.

setPerBuyerSignals

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

public AdSelectionConfig.Builder setPerBuyerSignals (Map<AdTechIdentifier, AdSelectionSignals> perBuyerSignals)

لتحديد الإشارات التي قدمها كل مشترٍ أثناء اختيار الإعلان.

إذا لم يتم ضبط السياسة، يتم ضبطها تلقائيًا على خريطة فارغة.

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getPerBuyerSignals().

المعلّمات
perBuyerSignals	Map: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.

تعيين بائع

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

public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

لضبط معرّف البائع.

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getSeller().

المعلّمات
seller	AdTechIdentifier: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.

تحديد إشارات البائع

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

public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

حدِّد الإشارات المستخدَمة لتعديل نتائج اختيار الإعلانات.

وفي حال تم ترك السياسة بدون ضبط، سيتم ضبط القيمة التلقائية على JSON الفارغ.

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getSellerSignals().

المعلّمات
sellerSignals	AdSelectionSignals: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.

setموثوقScoringSignalsUri

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

public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

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

في حال تجاوز Uri#EMPTY، سيتم تخطّي مكالمة الشبكة وسيتم تمرير AdSelectionSignals.EMPTY إلى اختيار الإعلان.

لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getTrustedScoringSignalsUri().

المعلّمات
trustedScoringSignalsUri	Uri: لا يمكن أن تكون هذه القيمة null.

الركلات المردودة
AdSelectionConfig.Builder	لا يمكن أن تكون هذه القيمة null.