مخاطبان سفارشی
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 () این URI به سروری اشاره میکند که توسط خریدار اداره میشود که میزبان دادههای پیشنهادی بهروز شده و ابردادههای تبلیغاتی است تا در فرآیند انتخاب آگهی روی دستگاه استفاده شود. |
Instant | getExpirationTime () پس از گذشت زمان انقضا، مخاطبان سفارشی دیگر واجد شرایط بهروزرسانی روزانه دادههای آگهی/مناقصه یا شرکت در فرآیند انتخاب آگهی نیستند. |
String | getName () نام مخاطب سفارشی یک رشته دلخواه است که توسط مالک و خریدار در ایجاد شیء |
TrustedBiddingData | getTrustedBiddingData () داده های مناقصه مورد اعتماد شامل یک URI است که به یک سرور قابل اعتماد برای داده های پیشنهادی خریداران اشاره می کند و فهرستی از کلیدها برای پرس و جو از سرور. |
AdSelectionSignals | getUserBiddingSignals () سیگنالهای پیشنهاد کاربر بهصورت اختیاری توسط خریداران ارائه میشوند تا توسط جاوا اسکریپت ارائهشده توسط خریدار در حین انتخاب آگهی در یک محیط اجرای ایزوله مصرف شوند. |
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 در غیر این صورت |
getActivationTime
public Instant getActivationTime ()
هنگام ایجاد شیء CustomAudience
، ممکن است در آینده یک زمان فعال سازی اختیاری تنظیم شود تا فعال سازی با تاخیر انجام شود. اگر فیلد تنظیم نشده باشد، CustomAudience
در زمان عضویت فعال می شود.
به عنوان مثال، یک مخاطب سفارشی برای کاربرانی که از کار افتاده اند ممکن است تا زمانی که به آستانه عدم فعالیت نرسیده باشد، فعال نشود، در این مرحله تبلیغات مخاطبان سفارشی در فرآیند انتخاب آگهی شرکت می کنند و به طور بالقوه کاربران از کار افتاده را به برنامه مالک اصلی هدایت می کنند.
حداکثر تاخیر در فعال سازی 60 روز از زمان ایجاد اولیه است.
اگر مشخص شده باشد، زمان فعال سازی باید یک لحظه زودتر از زمان انقضا باشد.
برمی گرداند | |
---|---|
Instant | مُهر زمان Instant ، به میلی ثانیه کوتاه شده است، پس از آن مخاطب سفارشی فعال می شود این مقدار ممکن است null باشد. |
getAds
public List<AdData> getAds ()
این لیست از اشیاء AdData
یک لیست کامل و کامل از تبلیغاتی است که توسط این CustomAudience
در طول فرآیند انتخاب آگهی ارائه می شود.
اگر مشخص نشده باشد، یا اگر یک لیست خالی ارائه شود، CustomAudience
تا زمانی که لیست معتبری از تبلیغات از طریق بهروزرسانی روزانه برای مخاطبان سفارشی ارائه نشود، در انتخاب آگهی شرکت نمیکنند.
برمی گرداند | |
---|---|
List < AdData > | List از اشیاء AdData که نشان دهنده تبلیغاتی است که در حال حاضر توسط مخاطبان سفارشی ارائه می شود. این مقدار نمی تواند null باشد. |
getBiddingLogicUri
public Uri getBiddingLogicUri ()
URI هدف مورد استفاده برای واکشی منطق مناقصه زمانی که یک مخاطب سفارشی در فرآیند انتخاب آگهی شرکت میکند را برمیگرداند. URI باید از HTTPS استفاده کند.
برمی گرداند | |
---|---|
Uri | URI برای واکشی منطق پیشنهاد خریدار این مقدار نمی تواند null باشد. |
خریدار
public AdTechIdentifier getBuyer ()
خریدار توسط دامنه ای به شکل "buyerexample.com" شناسایی می شود.
برمی گرداند | |
---|---|
AdTechIdentifier | یک AdTechIdentifier حاوی دامنه خریدار مخاطب سفارشی این مقدار نمی تواند null باشد. |
getDailyUpdateUri
public Uri getDailyUpdateUri ()
این URI به سروری اشاره میکند که توسط خریدار اداره میشود که میزبان دادههای پیشنهادی بهروز شده و ابردادههای تبلیغاتی است تا در فرآیند انتخاب آگهی روی دستگاه استفاده شود. URI باید از HTTPS استفاده کند.
برمی گرداند | |
---|---|
Uri | URI بهروزرسانی روزانه مخاطبان سفارشی این مقدار نمیتواند null باشد. |
getExpirationTime
public Instant getExpirationTime ()
پس از گذشت زمان انقضا، مخاطبان سفارشی دیگر واجد شرایط بهروزرسانی روزانه دادههای آگهی/مناقصه یا شرکت در فرآیند انتخاب آگهی نیستند. سپس مخاطبان سفارشی تا به روز رسانی روزانه بعدی از حافظه حذف خواهند شد.
اگر زمان انقضا در ایجاد CustomAudience
ارائه نشود، انقضا به طور پیش فرض 60 روز از زمان فعال سازی خواهد بود.
حداکثر انقضا 60 روز از زمان فعال سازی اولیه است.
برمی گرداند | |
---|---|
Instant | مُهر زمان Instant ، به میلی ثانیه کوتاه شده است، پس از آن مخاطب سفارشی باید حذف شود. این مقدار ممکن است null باشد. |
getName
public String getName ()
نام مخاطب سفارشی یک رشته دلخواه است که توسط مالک و خریدار در ایجاد شیء CustomAudience
ارائه شده است.
برمی گرداند | |
---|---|
String | نام رشته مخاطب سفارشی این مقدار نمی تواند null باشد. |
getTrustedBiddingData
public TrustedBiddingData getTrustedBiddingData ()
داده های مناقصه مورد اعتماد شامل یک URI است که به یک سرور قابل اعتماد برای داده های پیشنهادی خریداران اشاره می کند و فهرستی از کلیدها برای پرس و جو از سرور. توجه داشته باشید که کلیدها شناسههای دلخواه هستند که فقط برای پرس و جو از سرور مورد اعتماد برای منطق پیشنهاد خریدار در حین انتخاب آگهی استفاده میشوند.
اگر مشخص نشود، CustomAudience
در انتخاب آگهی شرکت نمیکنند تا زمانی که دادههای مناقصه مطمئن از طریق بهروزرسانی روزانه برای مخاطبان سفارشی ارائه شود.
برمی گرداند | |
---|---|
TrustedBiddingData | یک شی TrustedBiddingData حاوی داده های پیشنهادی مورد اعتماد مخاطبان سفارشی این مقدار ممکن است null باشد. |
getUserBiddingSignals
public AdSelectionSignals getUserBiddingSignals ()
سیگنالهای پیشنهاد کاربر بهصورت اختیاری توسط خریداران ارائه میشوند تا توسط جاوا اسکریپت ارائهشده توسط خریدار در حین انتخاب آگهی در یک محیط اجرای ایزوله مصرف شوند.
اگر سیگنالهای پیشنهاد کاربر یک شیء JSON معتبر که بتواند توسط JS خریدار مصرف شود نباشد، مخاطبان سفارشی واجد شرایط انتخاب آگهی نخواهند بود.
اگر مشخص نباشد، CustomAudience
تا زمانی که سیگنالهای پیشنهادی کاربر از طریق بهروزرسانی روزانه برای مخاطبان سفارشی ارائه نشود، در انتخاب آگهی شرکت نخواهد کرد.
برمی گرداند | |
---|---|
AdSelectionSignals | یک شی AdSelectionSignals نشان دهنده سیگنال های پیشنهادی کاربر برای مخاطبان سفارشی این مقدار ممکن است null باشد. |
هش کد
public int hashCode ()
هش داده های شیء CustomAudience
را برمی گرداند.
برمی گرداند | |
---|---|
int | یک مقدار کد هش برای این شی. |
writeToParcel
public void writeToParcel (Parcel dest, int flags)
این شی را در یک بسته صاف کنید.
پارامترها | |
---|---|
dest | Parcel : این مقدار نمی تواند null باشد. |
flags | int : پرچم های اضافی درباره نحوه نوشتن شی. ممکن است 0 یا Parcelable.PARCELABLE_WRITE_RETURN_VALUE باشد.PARCELABLE_WRITE_RETURN_VALUE. مقدار 0 است یا ترکیبی از Parcelable.PARCELABLE_WRITE_RETURN_VALUE و android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2024-08-20 بهوقت ساعت هماهنگ جهانی.