أداة إنشاء جمهور مخصّص

public static final class CustomAudience.Builder
extends Object

java.lang.Object
↳ android.adservices.customaudience.Customaudience.Builder

أداة إنشاء لـ CustomAudience عنصر

ملخّص

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

Builder()

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

CustomAudience build()

تنشئ هذه السياسة مثيلاً لـ CustomAudience.

CustomAudience.Builder setActivationTime(Instant activationTime)

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

CustomAudience.Builder setAds(List<AdData> ads)

تحدِّد إعلانات تجديد النشاط التسويقي الأولية التي يعرضها الجمهور المخصّص.

CustomAudience.Builder setBiddingLogicUri(Uri biddingLogicUri)

لتعيين عنوان URI لجلب منطق عرض الأسعار منه لاستخدامه في عملية اختيار الإعلانات.

CustomAudience.Builder setBuyer(AdTechIdentifier buyer)

تعيين المشتري AdTechIdentifier.

CustomAudience.Builder setDailyUpdateUri(Uri dailyUpdateUri)

تحدِّد هذه السياسة معرّف الموارد المنتظم (URI) للتحديث اليومي.

CustomAudience.Builder setExpirationTime(Instant expirationTime)

لضبط الوقت، يتم اقتطاعه إلى المللي ثانية، ويجب بعد ذلك إزالة السمة CustomAudience.

CustomAudience.Builder setName(String name)

لضبط اسم الكائن CustomAudience.

CustomAudience.Builder setTrustedBiddingData(TrustedBiddingData trustedBiddingData)

تُحدِّد بيانات عروض الأسعار الموثوق بها التي سيتم الاستعلام عنها واستخدامها في عملية اختيار الإعلانات.

CustomAudience.Builder setUserBiddingSignals(AdSelectionSignals userBiddingSignals)

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

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

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

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

إصدار

public CustomAudience build ()

تنشئ هذه السياسة مثيلاً لـ CustomAudience.

الركلات المردودة
CustomAudience لا يمكن أن تكون هذه القيمة null.
الرميات
NullPointerException إذا كانت أي معلمة غير فارغة هي قيمة فارغة
IllegalArgumentException إذا كان وقت انتهاء الصلاحية قبل وقت التفعيل
IllegalArgumentException إذا تم ضبط وقت انتهاء الصلاحية قبل الوقت الحالي

setActivateTime (وقت التفعيل)

public CustomAudience.Builder setActivationTime (Instant activationTime)

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

اضبط القيمة على null لكي يتم تفعيل CustomAudience على الفور والمشاركة في اختيار الإعلانات.

يمكنك الاطّلاع على CustomAudience.getActivationTime() لمزيد من المعلومات.

المعلّمات
activationTime Instant: قد تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder

setAds

public CustomAudience.Builder setAds (List<AdData> ads)

تحدِّد إعلانات تجديد النشاط التسويقي الأولية التي يعرضها الجمهور المخصّص. وسيتم تخصيصه بقائمة فارغة في حال عدم توفيره.

يمكنك الاطّلاع على CustomAudience.getAds() لمزيد من المعلومات.

المعلّمات
ads List: قد تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

setعروض الأسعارLogicUri

public CustomAudience.Builder setBiddingLogicUri (Uri biddingLogicUri)

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

يمكنك الاطّلاع على CustomAudience.getBiddingLogicUri() لمزيد من المعلومات.

المعلّمات
biddingLogicUri Uri: لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

تعيين المشتري

public CustomAudience.Builder setBuyer (AdTechIdentifier buyer)

تعيين المشتري AdTechIdentifier.

يمكنك الاطّلاع على CustomAudience.getBuyer() لمزيد من المعلومات.

المعلّمات
buyer AdTechIdentifier: لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

setDailyUpdateUri

public CustomAudience.Builder setDailyUpdateUri (Uri dailyUpdateUri)

تحدِّد هذه السياسة معرّف الموارد المنتظم (URI) للتحديث اليومي. يجب أن يستخدم معرّف الموارد المنتظم (URI) بروتوكول HTTPS.

يمكنك الاطّلاع على CustomAudience.getDailyUpdateUri() لمزيد من المعلومات.

المعلّمات
dailyUpdateUri Uri: لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

وقت انتهاء الصلاحية

public CustomAudience.Builder setExpirationTime (Instant expirationTime)

لضبط الوقت، يتم اقتطاعه إلى المللي ثانية، ويجب بعد ذلك إزالة السمة CustomAudience.

يمكنك الاطّلاع على CustomAudience.getExpirationTime() لمزيد من المعلومات.

المعلّمات
expirationTime Instant: قد تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

اسم المجموعة

public CustomAudience.Builder setName (String name)

لضبط اسم الكائن CustomAudience.

يمكنك الاطّلاع على CustomAudience.getName() لمزيد من المعلومات.

المعلّمات
name String: لا يمكن أن تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

تعيين عروض الأسعار الموثوقة

public CustomAudience.Builder setTrustedBiddingData (TrustedBiddingData trustedBiddingData)

تُحدِّد بيانات عروض الأسعار الموثوق بها التي سيتم الاستعلام عنها واستخدامها في عملية اختيار الإعلانات.

يمكنك الاطّلاع على CustomAudience.getTrustedBiddingData() لمزيد من المعلومات.

المعلّمات
trustedBiddingData TrustedBiddingData: قد تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.

setUserPriceSignals

public CustomAudience.Builder setUserBiddingSignals (AdSelectionSignals userBiddingSignals)

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

يمكنك الاطّلاع على CustomAudience.getUserBiddingSignals() لمزيد من المعلومات.

المعلّمات
userBiddingSignals AdSelectionSignals: قد تكون هذه القيمة null.
الركلات المردودة
CustomAudience.Builder لا يمكن أن تكون هذه القيمة null.