الجمهور المخصص

public final class CustomAudience
extends Object implements Parcelable

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

يمثل المعلومات اللازمة لجمهور مخصّص للمشاركة في اختيار الإعلان.

الجمهور المخصّص هو مجموعة مجردة من المستخدِمين الذين لديهم اهتمامات واضحة مماثلة. هذا النمط الفئة هي مجموعة من بعض البيانات المخزّنة على جهاز ويكون ضروريًا لعرض الإعلانات. تستهدف جمهورًا مخصصًا واحدًا.

ملخّص

الصفوف المتداخلة

class CustomAudience.Builder

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

الثوابت المكتسَبة

الحقول

public static final Creator<CustomAudience> CREATOR

الطرق العامة

boolean equals(Object o)

تتحقّق مما إذا كان كائنان CustomAudience يحتويان على المعلومات نفسها.

Instant getActivationTime()

عند إنشاء عنصر CustomAudience، قد يتم ضبط وقت تفعيل اختياري في في المستقبل، بهدف خدمة التنشيط المتأخر.

List<AdData> getAds()

هذه القائمة التي تضم AdData عناصر هي قائمة كاملة وكاملة بالإعلانات التي سيتم التي سيتم عرضها من خلال CustomAudience أثناء عملية اختيار الإعلانات.

Uri getBiddingLogicUri()

تعرض عنوان URI المستهدف المستخدَم لاسترجاع منطق عروض الأسعار عندما يشارك جمهور مخصّص في عملية اختيار الإعلانات

AdTechIdentifier getBuyer()

يتم تحديد المشتري من خلال نطاق بالشكل "buyerexample.com".

Uri getDailyUpdateUri()

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

Instant getExpirationTime()

بعد انقضاء وقت انتهاء الصلاحية، لن تكون شريحة الجمهور المخصّصة مؤهَّلة لاستخدامها يوميًا تعديل بيانات الإعلانات أو عروض الأسعار أو المشاركة في عملية اختيار الإعلانات

String getName()

اسم الجمهور المخصّص هو سلسلة عشوائية يقدّمها المالك والمشتري عند الإنشاء للعنصر CustomAudience.

TrustedBiddingData getTrustedBiddingData()

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

AdSelectionSignals getUserBiddingSignals()

يتم تقديم إشارات عروض أسعار المستخدمين بشكل اختياري من خلال المشترين ليستعرضوها من قِبل المشترين. JavaScript أثناء اختيار الإعلان في بيئة تنفيذ منعزلة

int hashCode()

تعرض تجزئة بيانات عنصر CustomAudience.

void writeToParcel(Parcel dest, int flags)

عليك تسوية هذا العنصر في قطعة أرض.

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

الحقول

صانع محتوى

تمت الإضافة في المستوى 34 لواجهة برمجة التطبيقات
أيضًا في إضافات خدمات الإعلانات 4 
public static final Creator<CustomAudience> CREATOR

الطرق العامة

علامة يساوي

public boolean equals (Object o)

تتحقّق مما إذا كان كائنان CustomAudience يحتويان على المعلومات نفسها.

المعلمات
o Object: الكائن المرجعي المطلوب المقارنة معه
المرتجعات
boolean true إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ false بخلاف ذلك.

الحصول على وقت التفعيل

public Instant getActivationTime ()

عند إنشاء عنصر CustomAudience، قد يتم ضبط وقت تفعيل اختياري في في المستقبل، بهدف خدمة التنشيط المتأخر. وفي حال عدم ضبط هذا الحقل، سيتم تفعيل CustomAudience عند الانضمام.

على سبيل المثال، قد لا يتم تفعيل شريحة الجمهور المخصّصة للمستخدمين غير النشطين حتى بلوغ الحدّ الأدنى يبلغ عدد حالات عدم النشاط، وعندها ستشارك إعلانات الجمهور المخصّص في الإعلان عملية اختيار، من المحتمل أن تتم إعادة توجيه المستخدمين غير النشطين إلى تطبيق المالك الأصلي.

يبلغ الحد الأقصى لمهلة التفعيل 60 يومًا من تاريخ الإنشاء الأولي.

في حال تحديد وقت التفعيل، يجب أن يكون وقت التفعيل قبل وقت انتهاء الصلاحية.

المرتجعات
Instant الطابع الزمني Instant، يتم اقتطاعه إلى مللي ثانية، وبعدها شريحة الجمهور نشطة قد تكون هذه القيمة null.

الحصول على إعلانات

public List<AdData> getAds ()

هذه القائمة التي تضم AdData عناصر هي قائمة كاملة وكاملة بالإعلانات التي سيتم التي سيتم عرضها من خلال CustomAudience أثناء عملية اختيار الإعلانات.

وإذا لم يتم تحديده أو في حال تقديم قائمة فارغة، لن يتم إدخال السمة CustomAudience المشاركة في اختيار الإعلانات إلى أن يتم تقديم قائمة صالحة بالإعلانات عبر التحديث اليومي الجمهور المخصص.

المرتجعات
List<AdData> List من إجمالي AdData عنصر يمثّل الإعلانات التي يعرضها حاليًا جمهور مخصّص لا يمكن أن تكون هذه القيمة null.

الحصول على عروض الأسعار

public Uri getBiddingLogicUri ()

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

المرتجعات
Uri معرّف الموارد المنتظم (URI) لجلب منطق عروض أسعار المشتري لا يمكن أن تكون هذه القيمة null.

الحصول على مشتري

public AdTechIdentifier getBuyer ()

يتم تحديد المشتري من خلال نطاق بالشكل "buyerexample.com".

المرتجعات
AdTechIdentifier AdTechIdentifier التي تحتوي على نطاق المشتري للجمهور المخصّص لا يمكن أن تكون هذه القيمة null.

الحصول على DailyUpdateUri

public Uri getDailyUpdateUri ()

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

المرتجعات
Uri معرّف الموارد المنتظم (URI) للتحديث اليومي للجمهور المخصّص لا يمكن أن تكون هذه القيمة null.

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

public Instant getExpirationTime ()

بعد انقضاء وقت انتهاء الصلاحية، لن تكون شريحة الجمهور المخصّصة مؤهَّلة لاستخدامها يوميًا تعديل بيانات الإعلانات أو عروض الأسعار أو المشاركة في عملية اختيار الإعلانات الجمهور المخصص سيتم حذفه من الذاكرة في التحديث اليومي التالي.

إذا لم يتم تحديد وقت لانتهاء الصلاحية عند إنشاء CustomAudience، ستنتهي صلاحية حالة الصلاحية يتم ذلك تلقائيًا بعد 60 يومًا من تاريخ التفعيل.

الحد الأقصى لانتهاء الصلاحية هو 60 يومًا من التفعيل الأولي.

المرتجعات
Instant الطابع الزمني Instant، يتم اقتطاعه إلى مللي ثانية، وبعدها يجب إزالة شريحة الجمهور قد تكون هذه القيمة null.

الحصول على اسم

public String getName ()

اسم الجمهور المخصّص هو سلسلة عشوائية يقدّمها المالك والمشتري عند الإنشاء للعنصر CustomAudience.

المرتجعات
String اسم السلسلة للجمهور المخصّص لا يمكن أن تكون هذه القيمة null.

الحصول على بيانات موثوقة في عروض الأسعار

public TrustedBiddingData getTrustedBiddingData ()

تتألّف بيانات عروض الأسعار الموثوق بها من معرّف موارد منتظم (URI) يشير إلى خادم موثوق به للمشترين بيانات عروض الأسعار وقائمة من المفاتيح للاستعلام عن الخادم. ملاحظة: إنّ المفاتيح عبارة عن معرّفات عشوائية تُستخدم فقط لطلب البحث في الخادم الموثوق به عن منطق عروض الأسعار للمشتري أثناء عرض الإعلان التحديد.

في حال عدم تحديده، لن يشارك CustomAudience في اختيار الإعلانات حتى يتم توفير بيانات عروض الأسعار الموثوق بها من خلال التعديل اليومي للجمهور المخصّص.

المرتجعات
TrustedBiddingData عنصر TrustedBiddingData يحتوي على عروض الأسعار الموثوق بها للجمهور المخصّص البيانات قد تكون هذه القيمة null.

الحصول على إشارات عروض أسعار المستخدم

public AdSelectionSignals getUserBiddingSignals ()

يتم تقديم إشارات عروض أسعار المستخدمين بشكل اختياري من خلال المشترين ليستعرضوها من قِبل المشترين. JavaScript أثناء اختيار الإعلان في بيئة تنفيذ منعزلة

إذا لم تكن إشارات عروض أسعار المستخدم عبارة عن عنصر JSON صالح يمكن أن يستخدمه JavaScript الخاص بالمشتري، فلن يكون الجمهور المخصّص مؤهلاً لاختيار الإعلانات.

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

المرتجعات
AdSelectionSignals عنصر AdSelectionSignals يمثّل إشارات عروض أسعار المستخدمين من أجل جمهور مخصّص قد تكون هذه القيمة null.

رمز التجزئة

public int hashCode ()

تعرض تجزئة بيانات عنصر CustomAudience.

المرتجعات
int قيمة رمز التجزئة لهذا الكائن.

كتابة ToParcel

public void writeToParcel (Parcel dest, 
                int flags)

عليك تسوية هذا العنصر في قطعة أرض.

المعلمات
dest Parcel: لا يمكن أن تكون هذه القيمة null.
flags int: علامات إضافية حول الطريقة التي يجب كتابة العنصر بها قد تكون القيمة 0 أو Parcelable.PARCELABLE_WRITE_RETURN_VALUE. القيمة هي 0 أو مجموعة من Parcelable.PARCELABLE_WRITE_RETURN_VALUE وandroid.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES