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

ملخص: المدراء | الطُرق | الطرق المكتسبة

أداة إنشاء AdSelectionConfig

public static final class AdSelectionConfig.Builder
extends Object

java.lang.Object
↳	android.adservices.adselection.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.

setCustom Audienceالمشترون

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

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

تحدِّد هذه السياسة قائمة المشترين المسموح بهم.

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

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

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

مجموعة DecisionLogicUri

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

public AdSelectionConfig.Builder setDecisionLogicUri (Uri decisionLogicUri)

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

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

  النصوص البرمجية المتوفرة مسبقًا:

  • 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.

setPerمشتريSignals

تمت الإضافة في المستوى 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.

تعيين TrustedScoringSignalsUri

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

public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

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

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

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

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

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