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

ملخص: الصفوف المتداخلة | الثوابت المكتسَبة | الحقول | الطُرق | الطرق المكتسبة

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

public final class CustomAudience
extends Object implements Parcelable

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

---

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

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

ملخّص

الصفوف المتداخلة
class	CustomAudience.Builder أداة إنشاء CustomAudience عنصر

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

من الواجهة android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR وحدة بت الواصف المستخدمة مع describeContents(): تشير إلى أن يتضمن التمثيل المسطَّح للكائن القابل للبرمجة واصف الملف. int PARCELABLE_WRITE_RETURN_VALUE علامة للاستخدام مع writeToParcel(Parcel, int): الكائن الذي تتم كتابته هي القيمة المعروضة، التي هي نتيجة دالة مثل "Parcelable someFunction()", "void someFunction(out Parcelable)"، أو "void someFunction(inout Parcelable)".

الحقول
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) عليك تسوية هذا العنصر في قطعة أرض.

الطرق المكتسبة
من الصف 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() يؤدي إلى أن ينتظر مؤشر ترابط السلسلة الحالية حتى يتم تنشيطها، وعادةً ما يؤدي ذلك إلى عن طريق الإشعارات أو المقاطعة.
من الواجهة android.os.Parcelable abstract int describeContents() وصْف أنواع العناصر الخاصة المضمّنة في هذا العنصر المثيل المنظَّم. abstract void writeToParcel(Parcel dest, int flags) عليك تسوية هذا العنصر في قطعة أرض.

الحقول

صانع محتوى

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

public static final Creator<CustomAudience> CREATOR

الطرق العامة

علامة يساوي

تمّت الإضافة في المستوى 34 لواجهة برمجة التطبيقات

public boolean equals (Object o)

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

المعلمات
o	Object: الكائن المرجعي المطلوب المقارنة معه

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

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

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

public Instant getActivationTime ()

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

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

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

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

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

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

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

public List<AdData> getAds ()

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

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

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

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

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

public Uri getBiddingLogicUri ()

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

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

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

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

public AdTechIdentifier getBuyer ()

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

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

الحصول على DailyUpdateUri

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

public Uri getDailyUpdateUri ()

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

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

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

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

public Instant getExpirationTime ()

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

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

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

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

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

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

public String getName ()

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

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

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

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

public TrustedBiddingData getTrustedBiddingData ()

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

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

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

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

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

public AdSelectionSignals getUserBiddingSignals ()

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

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

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

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

رمز التجزئة

تمّت الإضافة في المستوى 34 لواجهة برمجة التطبيقات

public int hashCode ()

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

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

كتابة ToParcel

تمّت الإضافة في المستوى 34 لواجهة برمجة التطبيقات

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