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

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()

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

Instant getExpirationTime()

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

String getName()

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

TrustedBiddingData getTrustedBiddingData()

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

AdSelectionSignals getUserBiddingSignals()

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

int hashCode()

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

void writeToParcel(Parcel dest, int flags)

انقِل هذا العنصر إلى طرد.

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

الحقول

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

علامة يساوي

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