AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable گسترش می دهد

java.lang.object
↳ android.adservices.adselection.AdSelectionConfig

شامل پیکربندی فرآیند انتخاب آگهی است.

نمونه‌های این کلاس توسط SDK ایجاد می‌شوند تا به‌عنوان آرگومان‌های AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) و AdSelectionManager#reportImpression در روش‌های AdSelectionManager ارائه شوند.

خلاصه

کلاس های تو در تو

class AdSelectionConfig.Builder

سازنده برای شی AdSelectionConfig .

ثابت های ارثی

فیلدها

public static final Creator < AdSelectionConfig > CREATOR

روش های عمومی

int describeContents ()

انواع اشیاء ویژه موجود در نمایش مارشال شده این نمونه Parcelable را شرح دهید.

boolean equals ( Object o)

نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر.

AdSelectionSignals getAdSelectionSignals ()
List < AdTechIdentifier > getCustomAudienceBuyers ()
Uri getDecisionLogicUri ()
Map < AdTechIdentifier , AdSelectionSignals > getPerBuyerSignals ()
AdTechIdentifier getSeller ()
AdSelectionSignals getSellerSignals ()
Uri getTrustedScoringSignalsUri ()
int hashCode ()

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

void writeToParcel ( Parcel dest, int flags)

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

روش های ارثی

فیلدها

خالق

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

روش های عمومی

توصیف محتوا

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

انواع اشیاء ویژه موجود در نمایش مارشال شده این نمونه Parcelable را شرح دهید. به عنوان مثال، اگر شی شامل یک توصیفگر فایل در خروجی writeToParcel(android.os.Parcel, int) باشد، مقدار بازگشتی این روش باید شامل بیت CONTENTS_FILE_DESCRIPTOR باشد.

برمی گرداند
int یک بیت ماسک که مجموعه‌ای از انواع شیء خاص را نشان می‌دهد که توسط این نمونه شیء Parcelable تنظیم شده است. مقدار 0 یا CONTENTS_FILE_DESCRIPTOR است

برابر است

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

نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر.

متد equals یک رابطه هم ارزی را در مراجع شی غیر تهی پیاده سازی می کند:

  • بازتابی است: برای هر مقدار مرجع غیر تهی x ، x.equals(x) باید true برگرداند.
  • متقارن است: برای هر مقدار مرجع غیر تهی x و y ، x.equals(y) باید true را برگرداند اگر و فقط اگر y.equals(x) true را برگرداند.
  • انتقالی است: برای هر مقدار مرجع غیر تهی x ، y ، و z ، اگر x.equals(y) true و y.equals(z) true را برمی گرداند، آنگاه x.equals(z) باید true برگرداند.
  • سازگار است: برای هر مقدار مرجع غیر تهی x و y ، فراخوانی های متعدد x.equals(y) به طور پیوسته true یا به طور پیوسته false را برمی گرداند، مشروط بر اینکه هیچ اطلاعاتی که در مقایسه های equals بر روی اشیاء استفاده می شود اصلاح نشود.
  • برای هر مقدار مرجع غیر تهی x ، x.equals(null) باید false برگرداند.

متد equals برای کلاس Object متمایزترین رابطه هم ارزی ممکن را روی اشیا پیاده سازی می کند. یعنی، برای هر مقدار مرجع غیر تهی x و y ، این روش اگر و فقط اگر x و y به یک شی اشاره داشته باشند، true را برمی گرداند ( x == y مقدار true را دارد).

توجه داشته باشید که به طور کلی هر زمان که این روش نادیده گرفته می شود، باید متد hashCode را لغو کرد تا قرارداد کلی برای متد hashCode حفظ شود که بیان می کند که اشیاء مساوی باید دارای کدهای هش برابر باشند.

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

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

getAdSelectionSignals

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

برمی گرداند
AdSelectionSignals JSON در یک شی AdSelectionSignals، که از AdSelectionConfig واکشی شده و توسط منطق JS واکشی شده از DSP مصرف می‌شود، سیگنال‌هایی را نشان می‌دهد که به خریداران شرکت‌کننده در فرآیندهای انتخاب و گزارش آگهی داده می‌شود. این مقدار نمی تواند null باشد.

getCustomAudienceBuyers

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

برمی گرداند
List < AdTechIdentifier > لیستی از خریداران مخاطب سفارشی که توسط SSP مجاز به شرکت در فرآیند انتخاب آگهی هستند این مقدار نمی تواند null باشد.

getDecisionLogicUri

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

برمی گرداند
Uri URI مورد استفاده برای بازیابی کد JS حاوی تابع Seller/SSP scoreAd که در طی فرآیندهای انتخاب آگهی و گزارش استفاده می شود این مقدار نمی تواند null باشد.

getPerBuyerSignals

در سطح API 34 اضافه شد
همچنین در Ad Services Extensions 4 
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

برمی گرداند
Map < AdTechIdentifier , AdSelectionSignals > یک نقشه از خریداران و AdSelectionSignals، که از AdSelectionConfig واکشی شده و توسط منطق JS واکشی شده از DSP مصرف می‌شود، نشان‌دهنده هرگونه اطلاعاتی است که هر خریدار در طول انتخاب آگهی به شرکت‌کنندگان ارائه می‌دهد (مانند کف قیمت، نوع انتخاب آگهی، و غیره) این مقدار نمی تواند null باشد.

دریافت فروشنده

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

برمی گرداند
AdTechIdentifier یک AdTechIdentifier از فروشنده، به عنوان مثال "www.example-ssp.com" این مقدار نمی تواند null باشد.

getSellerSignals

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

برمی گرداند
AdSelectionSignals JSON در یک شی AdSelectionSignals، ارائه شده توسط SSP و مصرف شده توسط منطق JS واکشی شده از SSP، هر گونه اطلاعاتی را نشان می دهد که SSP در فرآیند امتیازدهی تبلیغات استفاده می کند تا نتایج فرآیند انتخاب آگهی را تغییر دهد (مثلاً بررسی های ایمنی نام تجاری، مستثنی از شرایط متنی). تبلیغات). این مقدار نمی تواند null باشد.

getTrustedScoringSignalsUri

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

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

هش کد

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

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

قرارداد کلی hashCode این است:

  • هر گاه در طول اجرای یک برنامه جاوا بیش از یک بار بر روی یک شیء فراخوانی شود، متد hashCode باید به طور پیوسته همان عدد صحیح را برگرداند، مشروط بر اینکه هیچ اطلاعاتی که در مقایسه‌های equals روی شی مورد استفاده قرار می‌گیرد تغییر نکند. لازم نیست این عدد صحیح از یک اجرای یک برنامه به اجرای دیگری از همان برنامه ثابت بماند.
  • اگر دو شی با توجه به متد equals(Object) برابر باشند، فراخوانی متد hashCode روی هر یک از دو شیء باید یک عدد صحیح را ایجاد کند.
  • لازم نیست که اگر دو شی مطابق با متد equals(java.lang.Object) نابرابر باشند، فراخوانی متد hashCode روی هر یک از دو شیء باید نتایج اعداد صحیح متمایز ایجاد کند. با این حال، برنامه نویس باید آگاه باشد که تولید نتایج اعداد صحیح متمایز برای اشیاء نابرابر ممکن است عملکرد جداول هش را بهبود بخشد.

تا آنجا که عملی است، متد hashCode که توسط کلاس Object تعریف شده است، اعداد صحیح متمایز را برای اشیاء مجزا برمی گرداند. (HashCode ممکن است به عنوان تابعی از آدرس حافظه یک شی در نقطه ای از زمان اجرا شود یا نباشد.)

برمی گرداند
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