الجمهور المخصّص
public
final
class
CustomAudience
extends Object
implements
Parcelable
java.lang.Object | |
↳ | android.adservices.customaudience.Customaudience |
يقدِّم هذا التمثيل المعلومات اللازمة لكي يشارك جمهور مخصّص في اختيار الإعلانات.
الجمهور المخصّص هو مجموعة مجرّدة من المستخدِمين الذين لديهم اهتمامات معروضة مشابهة. هذه الفئة هي مجموعة من بعض البيانات المخزّنة على جهاز والتي تعد ضرورية لعرض إعلانات تستهدف شريحة جمهور مخصّصة واحدة.
ملخّص
الصفوف المتداخلة | |
---|---|
class |
CustomAudience.Builder
أداة إنشاء لـ |
الثوابت المكتسَبة |
---|
الحقول | |
---|---|
public
static
final
Creator<CustomAudience> |
CREATOR
|
الطرق المتاحة للجميع | |
---|---|
boolean
|
equals(Object o)
للتحقّق مما إذا كان عنصرا |
Instant
|
getActivationTime()
عند إنشاء العنصر |
List<AdData>
|
getAds()
هذه القائمة التي تتضمّن |
Uri
|
getBiddingLogicUri()
يتم عرض معرّف الموارد المنتظم (URI) المستهدَف المستخدَم لجلب منطق عروض الأسعار عندما يشارك جمهور مخصّص في عملية اختيار الإعلانات. |
AdTechIdentifier
|
getBuyer()
يتم تحديد المشتري من خلال نطاق بالشكل "buyerexample.com". |
Uri
|
getDailyUpdateUri()
يوجّه معرّف الموارد المنتظم هذا إلى خادم يديره المشتري يستضيف بيانات عروض الأسعار والبيانات الوصفية المعدّلة لاستخدامها في عملية اختيار الإعلانات على الجهاز فقط. |
Instant
|
getExpirationTime()
بعد انقضاء وقت انتهاء الصلاحية، لن يعود الجمهور المخصّص مؤهَّلاً لإجراء تعديلات يومية على بيانات الإعلانات/عروض الأسعار أو المشاركة في عملية اختيار الإعلانات. |
String
|
getName()
اسم الجمهور المخصّص هو سلسلة عشوائية يقدّمها المالك والمشتري عند إنشاء العنصر |
TrustedBiddingData
|
getTrustedBiddingData()
تتألف بيانات عروض الأسعار الموثوق بها من معرّف موارد منتظم (URI) يشير إلى خادم موثوق به لبيانات عروض أسعار المشترين وقائمة بمفاتيح طلب البحث من الخادم. |
AdSelectionSignals
|
getUserBiddingSignals()
يقدّم المشتري إشارات عروض أسعار المستخدم بشكل اختياري ليتم استخدامها من خلال رموز JavaScript التي يقدّمها المشتري أثناء اختيار الإعلان في بيئة تنفيذ منفصلة. |
int
|
hashCode()
لعرض تجزئة بيانات الكائن |
void
|
writeToParcel(Parcel dest, int flags)
انقِل هذا العنصر إلى طرد. |
الطرق المكتسبة | |
---|---|
الحقول
صانع محتوى
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 . |
إعلانات getAds
public List<AdData> getAds ()
هذه القائمة التي تتضمّن AdData
عناصر هي قائمة كاملة وكاملة بالإعلانات التي
سيعرضها هذا العنصر CustomAudience
أثناء عملية اختيار الإعلانات.
إذا لم يتم تحديد الإعلانات، أو إذا تم تقديم قائمة فارغة، لن تشارك CustomAudience
في اختيار الإعلانات إلى أن يتم توفير قائمة صالحة من الإعلانات من خلال التحديث اليومي
للجمهور المخصّص.
الركلات المردودة | |
---|---|
List<AdData> |
List من AdData عنصر يمثّل الإعلانات التي يعرضها الجمهور المخصّص حاليًا
لا يمكن أن تكون هذه القيمة null . |
الحصول علىعروض الأسعارLogicUri
public Uri getBiddingLogicUri ()
يتم عرض معرّف الموارد المنتظم (URI) المستهدَف المستخدَم لجلب منطق عروض الأسعار عندما يشارك جمهور مخصّص في عملية اختيار الإعلانات. يجب أن يستخدم معرّف الموارد المنتظم (URI) بروتوكول HTTPS.
الركلات المردودة | |
---|---|
Uri |
معرّف الموارد المنتظم (URI) لجلب منطق عروض أسعار المشتري
لا يمكن أن تكون هذه القيمة null . |
الحصول على مشتري
public AdTechIdentifier getBuyer ()
يتم تحديد المشتري من خلال نطاق بالشكل "buyerexample.com".
الركلات المردودة | |
---|---|
AdTechIdentifier |
AdTechIdentifier تحتوي على نطاق المشتري للجمهور المخصّص
لا يمكن أن تكون هذه القيمة null . |
الحصول على DailyUpdateUri
public Uri getDailyUpdateUri ()
يوجّه معرّف الموارد المنتظم هذا إلى خادم يديره المشتري يستضيف بيانات عروض الأسعار والبيانات الوصفية المعدّلة لاستخدامها في عملية اختيار الإعلانات على الجهاز فقط. يجب أن يستخدم معرّف الموارد المنتظم (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 . |
الحصول على معلومات عروض أسعار "عروض أسعار Google"
public AdSelectionSignals getUserBiddingSignals ()
يقدّم المشتري إشارات عروض أسعار المستخدم بشكل اختياري ليتم استخدامها من خلال رموز JavaScript التي يقدّمها المشتري أثناء اختيار الإعلان في بيئة تنفيذ منفصلة.
إذا لم تكن إشارات عروض أسعار المستخدِم عبارة عن عنصر JSON صالح يمكن استهلاكه من خلال JavaScript للمشتري، لن تكون شريحة الجمهور المخصّصة مؤهَّلة لاختيار الإعلان.
في حال عدم تحديد هذه السمة، لن تشارك السمة CustomAudience
في اختيار الإعلانات إلى أن
يتم توفير إشارات عروض أسعار للمستخدِم من خلال التعديل اليومي للجمهور المخصّص.
الركلات المردودة | |
---|---|
AdSelectionSignals |
عنصر AdSelectionSignals يمثّل إشارات عروض أسعار المستخدِم
للجمهور المخصّص
قد تكون هذه القيمة null . |
رمز التجزئة
public int hashCode ()
لعرض تجزئة بيانات الكائن CustomAudience
.
الركلات المردودة | |
---|---|
int |
قيمة رمز تجزئة لهذا الكائن. |
الكتابة إلىParcel
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 |