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

สรุป: คลาสที่ฝัง | ค่าคงที่ที่รับช่วงมา | ฟิลด์ | เมธอด | เมธอดที่รับช่วงมา

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

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

จากอินเทอร์เฟซ android.os.Parcelable 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) แปลงออบเจ็กต์นี้เป็นแปลง

วิธีการที่รับช่วงมา
จากชั้นเรียน 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
ยังมีในส่วนขยายโฆษณา 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