این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 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()` استفاده می شود: نشان می دهد که نمایش مسطح شیء Parcelable شامل یک توصیفگر فایل است.
`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 ()` سیگنال‌های پیشنهاد کاربر به‌صورت اختیاری توسط خریداران ارائه می‌شوند تا توسط جاوا اسکریپت ارائه‌شده توسط خریدار در حین انتخاب آگهی در یک محیط اجرای ایزوله مصرف شوند.
`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 ()` انواع اشیاء ویژه موجود در نمایش مارشال شده این نمونه Parcelable را شرح دهید.
`abstract 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