مخاطبان سفارشی

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

سیگنال‌های پیشنهاد کاربر به‌صورت اختیاری توسط خریداران ارائه می‌شوند تا توسط جاوا اسکریپت ارائه‌شده توسط خریدار در حین انتخاب آگهی در یک محیط اجرای ایزوله مصرف شوند.

int hashCode ()

هش داده های شیء CustomAudience را برمی گرداند.

void writeToParcel ( Parcel dest, int flags)

این شی را در یک بسته صاف کنید.

روش های ارثی

فیلدها

خالق

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public static final Creator<CustomAudience> CREATOR

روش های عمومی

برابر است

در سطح API 34 اضافه شد
public boolean equals (Object o)

بررسی می کند که آیا دو شیء CustomAudience حاوی اطلاعات یکسانی هستند یا خیر.

پارامترها
o Object : شی مرجعی که با آن مقایسه می شود.

برمی گرداند
boolean true اگر این شی همان آرگومان obj باشد. false در غیر این صورت

getActivationTime

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public Instant getActivationTime ()

هنگام ایجاد شیء CustomAudience ، ممکن است در آینده یک زمان فعال سازی اختیاری تنظیم شود تا فعال سازی با تاخیر انجام شود. اگر فیلد تنظیم نشده باشد، CustomAudience در زمان عضویت فعال می شود.

به عنوان مثال، یک مخاطب سفارشی برای کاربرانی که از کار افتاده اند ممکن است تا زمانی که به آستانه عدم فعالیت نرسیده باشد، فعال نشود، در این مرحله تبلیغات مخاطبان سفارشی در فرآیند انتخاب آگهی شرکت می کنند و به طور بالقوه کاربران از کار افتاده را به برنامه مالک اصلی هدایت می کنند.

حداکثر تاخیر در فعال سازی 60 روز از زمان ایجاد اولیه است.

اگر مشخص شده باشد، زمان فعال سازی باید یک لحظه زودتر از زمان انقضا باشد.

برمی گرداند
Instant مُهر زمان Instant ، به میلی ثانیه کوتاه شده است، پس از آن مخاطب سفارشی فعال می شود این مقدار ممکن است null باشد.

getAds

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public List<AdData> getAds ()

این لیست از اشیاء AdData یک لیست کامل و کامل از تبلیغاتی است که توسط این CustomAudience در طول فرآیند انتخاب آگهی ارائه می شود.

اگر مشخص نشده باشد، یا اگر یک لیست خالی ارائه شود، CustomAudience تا زمانی که لیست معتبری از تبلیغات از طریق به‌روزرسانی روزانه برای مخاطبان سفارشی ارائه نشود، در انتخاب آگهی شرکت نمی‌کنند.

برمی گرداند
List < AdData > List از اشیاء AdData که نشان دهنده تبلیغاتی است که در حال حاضر توسط مخاطبان سفارشی ارائه می شود. این مقدار نمی تواند null باشد.

getBiddingLogicUri

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public Uri getBiddingLogicUri ()

URI هدف مورد استفاده برای واکشی منطق مناقصه زمانی که یک مخاطب سفارشی در فرآیند انتخاب آگهی شرکت می‌کند را برمی‌گرداند. URI باید از HTTPS استفاده کند.

برمی گرداند
Uri URI برای واکشی منطق پیشنهاد خریدار این مقدار نمی تواند null باشد.

خریدار

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public AdTechIdentifier getBuyer ()

خریدار توسط دامنه ای به شکل "buyerexample.com" شناسایی می شود.

برمی گرداند
AdTechIdentifier یک AdTechIdentifier حاوی دامنه خریدار مخاطب سفارشی این مقدار نمی تواند null باشد.

getDailyUpdateUri

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public Uri getDailyUpdateUri ()

این URI به سروری اشاره می‌کند که توسط خریدار اداره می‌شود که میزبان داده‌های پیشنهادی به‌روز شده و ابرداده‌های تبلیغاتی است تا در فرآیند انتخاب آگهی روی دستگاه استفاده شود. URI باید از HTTPS استفاده کند.

برمی گرداند
Uri URI به‌روزرسانی روزانه مخاطبان سفارشی این مقدار نمی‌تواند null باشد.

getExpirationTime

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public Instant getExpirationTime ()

پس از گذشت زمان انقضا، مخاطبان سفارشی دیگر واجد شرایط به‌روزرسانی روزانه داده‌های آگهی/مناقصه یا شرکت در فرآیند انتخاب آگهی نیستند. سپس مخاطبان سفارشی تا به روز رسانی روزانه بعدی از حافظه حذف خواهند شد.

اگر زمان انقضا در ایجاد CustomAudience ارائه نشود، انقضا به طور پیش فرض 60 روز از زمان فعال سازی خواهد بود.

حداکثر انقضا 60 روز از زمان فعال سازی اولیه است.

برمی گرداند
Instant مُهر زمان Instant ، به میلی ثانیه کوتاه شده است، پس از آن مخاطب سفارشی باید حذف شود. این مقدار ممکن است null باشد.

getName

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public String getName ()

نام مخاطب سفارشی یک رشته دلخواه است که توسط مالک و خریدار در ایجاد شیء CustomAudience ارائه شده است.

برمی گرداند
String نام رشته مخاطب سفارشی این مقدار نمی تواند null باشد.

getTrustedBiddingData

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public TrustedBiddingData getTrustedBiddingData ()

داده های مناقصه مورد اعتماد شامل یک URI است که به یک سرور قابل اعتماد برای داده های پیشنهادی خریداران اشاره می کند و فهرستی از کلیدها برای پرس و جو از سرور. توجه داشته باشید که کلیدها شناسه های دلخواه هستند که فقط برای پرس و جو از سرور مورد اعتماد برای منطق پیشنهاد خریدار در حین انتخاب آگهی استفاده می شوند.

اگر مشخص نشود، CustomAudience در انتخاب آگهی شرکت نمی‌کنند تا زمانی که داده‌های مناقصه مطمئن از طریق به‌روزرسانی روزانه برای مخاطبان سفارشی ارائه شود.

برمی گرداند
TrustedBiddingData یک شی TrustedBiddingData حاوی داده های پیشنهادی مورد اعتماد مخاطبان سفارشی این مقدار ممکن است null باشد.

getUserBiddingSignals

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4
public AdSelectionSignals getUserBiddingSignals ()

سیگنال‌های پیشنهاد کاربر به‌صورت اختیاری توسط خریداران ارائه می‌شوند تا توسط جاوا اسکریپت ارائه‌شده توسط خریدار در حین انتخاب آگهی در یک محیط اجرای ایزوله مصرف شوند.

اگر سیگنال‌های پیشنهاد کاربر یک شیء JSON معتبر که بتواند توسط JS خریدار مصرف شود نباشد، مخاطبان سفارشی واجد شرایط انتخاب آگهی نخواهند بود.

اگر مشخص نباشد، CustomAudience تا زمانی که سیگنال‌های پیشنهادی کاربر از طریق به‌روزرسانی روزانه برای مخاطبان سفارشی ارائه نشود، در انتخاب آگهی شرکت نخواهد کرد.

برمی گرداند
AdSelectionSignals یک شی AdSelectionSignals نشان دهنده سیگنال های پیشنهادی کاربر برای مخاطبان سفارشی این مقدار ممکن است null باشد.

هش کد

در سطح API 34 اضافه شد
public int hashCode ()

هش داده های شیء CustomAudience را برمی گرداند.

برمی گرداند
int یک مقدار کد هش برای این شی.

writeToParcel

در سطح API 34 اضافه شد
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