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 

ค่าคงที่ที่รับช่วงมา

int CONTENTS_FILE_DESCRIPTOR

บิตตัวระบุที่ใช้กับ describeContents(): บ่งบอกว่าการแสดงผลแบบแบนของออบเจ็กต์ Parcelable มีตัวระบุไฟล์

int PARCELABLE_WRITE_RETURN_VALUE

Flag สำหรับใช้กับ writeToParcel(Parcel, int): ออบเจ็กต์ที่เขียนเป็นค่าที่แสดงผล ซึ่งเป็นผลลัพธ์ของฟังก์ชัน เช่น "Parcelable someFunction()", "void someFunction(out Parcelable)" หรือ "void someFunction(inout Parcelable)"

ช่อง

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)

แปลงออบเจ็กต์นี้เป็นแปลง

วิธีการที่รับช่วงมา

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

ทําให้เธรดปัจจุบันรอจนกว่าจะได้รับการปลุก ซึ่งโดยปกติแล้วคือการได้รับการแจ้งเตือนหรือถูกขัดจังหวะ

abstract int describeContents()

อธิบายชนิดของวัตถุพิเศษที่มีอยู่ในการแสดงมาร์แชลล์ของอินสแตนซ์ Parcelable นี้

abstract void writeToParcel(Parcel dest, int flags)

แปลงออบเจ็กต์นี้เป็นแปลง

ช่อง

ครีเอเตอร์

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย 
public static final Creator<AdSelectionConfig> CREATOR

เมธอดสาธารณะ

describeContents

เพิ่มใน API ระดับ 34 
public int describeContents ()

อธิบายประเภทของออบเจ็กต์พิเศษที่อยู่ในการแสดงผลที่มาร์แชลของอินสแตนซ์ Parcelable นี้ เช่น หากออบเจ็กต์จะรวมตัวระบุไฟล์ไว้ในเอาต์พุตของ writeToParcel(android.os.Parcel, int) ค่าที่แสดงผลของเมธอดนี้ต้องมีบิต CONTENTS_FILE_DESCRIPTOR

คิกรีเทิร์น
int บิตมาสก์ที่ระบุชุดประเภทออบเจ็กต์พิเศษที่จัดเรียงโดยอินสแตนซ์ออบเจ็กต์ที่แยกแยะได้นี้ ค่าคือ 0 หรือ CONTENTS_FILE_DESCRIPTOR

เท่ากับ

เพิ่มใน API ระดับ 34 แล้ว 
public boolean equals (Object o)

บ่งชี้ว่าออบเจ็กต์อื่น "เท่ากับ" ออบเจ็กต์นี้หรือไม่

เมธอด equals ใช้ความสัมพันธ์ที่เทียบเท่ากันกับการอ้างอิงออบเจ็กต์ที่ไม่ใช่ค่า Null ดังนี้

  • สะท้อนกลับ: สำหรับค่าอ้างอิงใดๆ ที่ไม่ใช่ค่า Null x x.equals(x) ควรแสดงผล true
  • สมมาตร: สำหรับค่าอ้างอิงใดๆ ที่ไม่ใช่ค่า Null x และ y x.equals(y) ควรแสดงผล true เฉพาะในกรณีที่ y.equals(x) แสดงผล true
  • การเปลี่ยนผ่าน: สำหรับค่าอ้างอิงใดๆ ที่ไม่ใช่ค่า Null อย่าง x, y และ z หาก x.equals(y) แสดงผล true และ y.equals(z) แสดงผล true x.equals(z) ก็ควรแสดงผล true ด้วย
  • มีความสอดคล้องกัน กล่าวคือ สำหรับค่าอ้างอิงที่ไม่เป็นค่าว่าง x และ y การเรียก x.equals(y) หลายครั้งจะแสดงผล true อย่างสม่ำเสมอ หรือแสดงผล false อย่างสม่ำเสมอ หากไม่มีการแก้ไขข้อมูลที่ใช้ในการเปรียบเทียบ equals ของออบเจ็กต์
  • สําหรับค่าอ้างอิง x ที่ไม่ใช่ค่า Null ควรแสดงผล falsex.equals(null)

เมธอด equals สำหรับคลาส Object ใช้ความสัมพันธ์ที่เทียบเท่ากันมากที่สุดที่เป็นไปได้กับออบเจ็กต์ กล่าวคือ สำหรับค่าอ้างอิง x และ y ที่ไม่ใช่ค่า Null เมธอดนี้จะแสดงผล true เฉพาะในกรณีที่ x และ y อ้างอิงถึงออบเจ็กต์เดียวกัน (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
ยังมีในส่วนขยายโฆษณา 4 ด้วย 
public List<AdTechIdentifier> getCustomAudienceBuyers ()

คิกรีเทิร์น
List<AdTechIdentifier> รายชื่อผู้ซื้อกลุ่มเป้าหมายที่กำหนดเองซึ่ง SSP อนุญาตให้เข้าร่วมกระบวนการเลือกโฆษณา ค่านี้ต้องไม่ใช่ null

getDecisionLogicUri

เพิ่มใน API ระดับ 34
และใน Ad Services Extensions 4 ด้วย 
public Uri getDecisionLogicUri ()

คิกรีเทิร์น
Uri URI ที่ใช้ในการดึงโค้ด JS ที่มีฟังก์ชัน ScoreAd ของผู้ขาย/SSP ที่ใช้ระหว่างกระบวนการเลือกโฆษณาและการรายงาน ค่านี้ต้องไม่เป็น null

getPerBuyerSignals

เพิ่มใน API ระดับ 34
และใน Ad Services Extensions 4 ด้วย 
public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

คิกรีเทิร์น
Map<AdTechIdentifier, AdSelectionSignals> แผนที่ของผู้ซื้อและ AdSelectionSignals ที่ดึงมาจาก AdSelectionConfig และระบบใช้ตรรกะ JS ที่ดึงมาจาก DSP ซึ่งแสดงข้อมูลทั้งหมดที่ผู้ซื้อแต่ละรายจะให้ในระหว่างการเลือกโฆษณาแก่ผู้เข้าร่วม (เช่น ราคาเสนอต่ำสุด ประเภทการเลือกโฆษณา ฯลฯ) ค่านี้ต้องไม่เป็น null

getSeller

เพิ่มใน 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

hashCode

เพิ่มใน API ระดับ 34 
public int hashCode ()

แสดงผลค่ารหัสแฮชสําหรับออบเจ็กต์ ระบบรองรับเมธอดนี้เพื่อประโยชน์ของตารางแฮช เช่น ตารางที่ HashMap ให้บริการ

สัญญาทั่วไปของ hashCode คือ

  • เมื่อใดก็ตามที่มีการเรียกใช้กับออบเจ็กต์เดียวกันมากกว่า 1 ครั้งระหว่างการเรียกใช้แอปพลิเคชัน Java เมธอด hashCode จะต้องแสดงผลลัพธ์จำนวนเต็มเดียวกันเสมอ เว้นแต่จะมีการแก้ไขข้อมูลที่ใช้ในการเปรียบเทียบ equals กับออบเจ็กต์ จำนวนเต็มนี้ไม่จำเป็นต้องสอดคล้องกันตั้งแต่การเรียกใช้แอปพลิเคชันหนึ่งไปจนถึงการเรียกใช้แอปพลิเคชันเดียวกันอีก
  • หากออบเจ็กต์ 2 รายการเท่ากันตามเมธอด equals(Object) การเรียกเมธอด hashCode ในแต่ละออบเจ็กต์ของทั้ง 2 ออบเจ็กต์จะต้องให้ผลลัพธ์จำนวนเต็มเหมือนกัน
  • คุณไม่จำเป็นต้องว่าหากออบเจ็กต์ 2 รายการไม่เท่ากันตามเมธอด equals(java.lang.Object) การเรียกเมธอด hashCode ในแต่ละออบเจ็กต์ของทั้ง 2 ออบเจ็กต์จะต้องให้ผลลัพธ์ที่เป็นจำนวนเต็มที่แตกต่างกัน อย่างไรก็ตาม โปรแกรมเมอร์ควรตระหนักว่าการสร้างผลลัพธ์จำนวนเต็มที่แตกต่างกันสำหรับออบเจ็กต์ที่ไม่เท่ากันอาจช่วยปรับปรุงประสิทธิภาพของตารางแฮชได้

ฟังก์ชัน hashCode ที่กําหนดโดยคลาส Object จะแสดงผลลัพธ์จำนวนเต็มที่ไม่ซ้ำกันสําหรับออบเจ็กต์ที่ไม่ซ้ำกัน (ระบบอาจใช้หรือไม่ใช้ hashCode เป็นฟังก์ชันบางอย่างของที่อยู่หน่วยความจำของออบเจ็กต์ ณ เวลาหนึ่งๆ)

คิกรีเทิร์น
int ค่ารหัสแฮชสําหรับออบเจ็กต์นี้

writeToParcel

เพิ่มใน API ระดับ 34 แล้ว 
public void writeToParcel (Parcel dest, 
                int flags)

แปลงออบเจ็กต์นี้เป็นแปลง

พารามิเตอร์
dest Parcel: ค่านี้ต้องไม่เป็น null
flags int: Flag เพิ่มเติมเกี่ยวกับวิธีเขียนออบเจ็กต์ อาจเป็น 0 หรือ Parcelable.PARCELABLE_WRITE_RETURN_VALUE ค่าคือ 0 หรือทั้ง Parcelable.PARCELABLE_WRITE_RETURN_VALUE และ android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES