AdSelectionConfig.Builder
public
static
final
class
AdSelectionConfig.Builder
extends Object
java.lang.Object | |
↳ | android.adservices.ads select.AdSelectionConfig.Builder |
أداة إنشاء لعنصر "AdSelectionConfig
"
ملخّص
شركات الإنشاءات العامة | |
---|---|
Builder()
|
الطرق المتاحة للجميع | |
---|---|
AdSelectionConfig
|
build()
لإنشاء مثيل |
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 . |
setCustomAudienceBuyers
public AdSelectionConfig.Builder setCustomAudienceBuyers (List<AdTechIdentifier> customAudienceBuyers)
إعداد قائمة بالمشترين المسموح بهم
لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getCustomAudienceBuyers()
.
المعلّمات | |
---|---|
customAudienceBuyers |
List : لا يمكن أن تكون هذه القيمة null . |
الركلات المردودة | |
---|---|
AdSelectionConfig.Builder |
لا يمكن أن تكون هذه القيمة null . |
setDecisionLogicUri
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
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 . |
setموثوقScoringSignalsUri
public AdSelectionConfig.Builder setTrustedScoringSignalsUri (Uri trustedScoringSignalsUri)
لضبط نقطة نهاية معرّف الموارد المنتظم (URI) لإشارة موثوق بها من جهة البيع، يمكن الحصول من خلالها على معلومات محدّدة في الوقت الفعلي لتصميم الإعلان.
في حال تجاوز Uri#EMPTY
، سيتم تخطّي مكالمة الشبكة وسيتم تمرير AdSelectionSignals.EMPTY
إلى اختيار الإعلان.
لمزيد من التفاصيل، يُرجى الانتقال إلى AdSelectionConfig.getTrustedScoringSignalsUri()
.
المعلّمات | |
---|---|
trustedScoringSignalsUri |
Uri : لا يمكن أن تكون هذه القيمة null . |
الركلات المردودة | |
---|---|
AdSelectionConfig.Builder |
لا يمكن أن تكون هذه القيمة null . |