أداة إنشاء 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) لإشارة موثوق بها من جهة البيع والتي يتم من خلالها تحديد تصميم إعلان في الوقت الفعلي التي يمكن استرجاع المعلومات منها.

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

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

البنّاء

public Builder ()

الطرق العامة

بناء

public AdSelectionConfig build ()

تنشئ مثيل AdSelectionConfig.

المرتجعات
AdSelectionConfig لا يمكن أن تكون هذه القيمة null.
الرميات
NullPointerException إذا كانت أي من المعلمات المطلوبة فارغة

setAdSelectionSignals

public AdSelectionConfig.Builder setAdSelectionSignals (AdSelectionSignals adSelectionSignals)

تضبط هذه السياسة الإشارات المقدَّمة للمشترين أثناء إنشاء عروض أسعار اختيار الإعلانات.

وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام ملف JSON الفارغ تلقائيًا.

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

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

setCustom Audienceالمشترون

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

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

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

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

مجموعة DecisionLogicUri

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

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

تضبط هذه السياسة الإشارات التي يقدّمها كل مشترٍ أثناء اختيار الإعلانات.

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

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

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

ضبط البائع

public AdSelectionConfig.Builder setSeller (AdTechIdentifier seller)

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

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

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

تعيين إشارات البائع

public AdSelectionConfig.Builder setSellerSignals (AdSelectionSignals sellerSignals)

يمكنك ضبط الإشارات المستخدَمة لتعديل نتائج اختيار الإعلانات.

وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام ملف JSON الفارغ تلقائيًا.

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

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

تعيين TrustedScoringSignalsUri

public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)

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

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

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

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