กลุ่มเป้าหมายที่กำหนดเอง

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 2 รายการมีข้อมูลเดียวกันหรือไม่

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

ผู้ซื้อเลือกสัญญาณการเสนอราคาของผู้ใช้ให้ผู้ซื้อได้ใช้โดยผู้ซื้อ JavaScript ในระหว่างการเลือกโฆษณาในสภาพแวดล้อมการดำเนินการที่แยกต่างหาก

int hashCode()

แสดงผลแฮชของข้อมูลของออบเจ็กต์ CustomAudience

void writeToParcel(Parcel dest, int flags)

แยกวัตถุนี้ลงในแปลงที่ดิน

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

ช่อง

ครีเอเตอร์

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

วิธีการสาธารณะ

เท่ากับ

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

ตรวจสอบว่าออบเจ็กต์ CustomAudience 2 รายการมีข้อมูลเดียวกันหรือไม่

พารามิเตอร์
o Object: ออบเจ็กต์อ้างอิงที่จะใช้เปรียบเทียบ

คิกรีเทิร์น
boolean true หากวัตถุนี้เหมือนกับ obj ข้อโต้แย้ง; false หรือไม่เช่นนั้น

getActivationTime

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public Instant getActivationTime ()

เมื่อสร้างออบเจ็กต์ CustomAudience อาจตั้งเวลาเปิดใช้งานหรือไม่ก็ได้ใน เพื่อให้บริการการเปิดใช้งานที่ล่าช้า หากไม่ได้ตั้งค่าช่องนี้ไว้ CustomAudience จะเปิดใช้งานเมื่อเข้าร่วม

ตัวอย่างเช่น กลุ่มเป้าหมายที่กําหนดเองสําหรับผู้ใช้ที่หยุดใช้งานอาจไม่เปิดใช้งานจนกว่าจะถึงเกณฑ์ของ ถึงจุดนี้เมื่อไม่มีการใช้งาน โฆษณาของกลุ่มเป้าหมายที่กำหนดเองจะเข้าร่วมในโฆษณา ซึ่งอาจเปลี่ยนเส้นทางผู้ใช้ที่หยุดใช้งานไปยังแอปพลิเคชันของเจ้าของเดิม

ความล่าช้าสูงสุดในการเปิดใช้งานคือ 60 วันนับจากวันที่สร้างครั้งแรก

หากระบุ เวลาเปิดใช้งานจะต้องเร็วกว่าเวลาหมดอายุ

คิกรีเทิร์น
Instant การประทับเวลา Instant จะถูกตัดเป็นมิลลิวินาที จากนั้นที่กำหนดเอง กลุ่มเป้าหมายใช้งานอยู่ ค่านี้อาจเป็น null

GetAds

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public List<AdData> getAds ()

รายการออบเจ็กต์ AdData รายการนี้เป็นรายการโฆษณาทั้งหมดที่จะ แสดงโดย CustomAudience นี้ในระหว่างขั้นตอนการเลือกโฆษณา

หากไม่ได้ระบุไว้หรือมีรายการที่ว่างเปล่า CustomAudience จะไม่ เข้าร่วมการเลือกโฆษณาจนกว่าจะมีการระบุรายการโฆษณาที่ถูกต้องผ่านการอัปเดตรายวันสำหรับ กลุ่มเป้าหมายที่กำหนดเอง

คิกรีเทิร์น
List<AdData> ออบเจ็กต์ List จาก AdData รายการซึ่งแสดงโฆษณาที่แสดงโดย กลุ่มเป้าหมายที่กำหนดเอง ค่านี้ต้องไม่เป็น null

getการเสนอราคาLogicUri

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public Uri getBiddingLogicUri ()

แสดง URI เป้าหมายที่ใช้ในการดึงตรรกะการเสนอราคาเมื่อกลุ่มเป้าหมายที่กำหนดเองเข้าร่วมใน ในการเลือกโฆษณา URI ต้องใช้ HTTPS

คิกรีเทิร์น
Uri URI สำหรับดึงข้อมูลตรรกะการเสนอราคาของผู้ซื้อ ค่านี้ต้องไม่เป็น null

getBuyer

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public AdTechIdentifier getBuyer ()

ผู้ซื้อจะได้รับการระบุโดยโดเมนในรูปแบบ "buyerexample.com"

คิกรีเทิร์น
AdTechIdentifier AdTechIdentifier ที่มีโดเมนผู้ซื้อของกลุ่มเป้าหมายที่กำหนดเอง ค่านี้ต้องไม่เป็น null

ดูการอัปเดตรายวัน

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public Uri getDailyUpdateUri ()

URI นี้ชี้ไปยังเซิร์ฟเวอร์ที่ผู้ซื้อดำเนินการ ซึ่งโฮสต์ข้อมูลการเสนอราคาและข้อมูลเมตาของโฆษณาที่อัปเดตแล้ว ที่จะใช้ในกระบวนการเลือกโฆษณาในอุปกรณ์ URI ต้องใช้ HTTPS

คิกรีเทิร์น
Uri URI อัปเดตรายวันของกลุ่มเป้าหมายที่กำหนดเอง ค่านี้ต้องไม่เป็น null

รับเวลาหมดอายุ

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public Instant getExpirationTime ()

หลังจากผ่านเวลาหมดอายุ กลุ่มเป้าหมายที่กําหนดเองจะไม่มีสิทธิ์แสดงแบบรายวันอีกต่อไป การอัปเดตข้อมูลโฆษณา/การเสนอราคาหรือการเข้าสู่กระบวนการเลือกโฆษณา กลุ่มเป้าหมายที่กำหนดเอง จะถูกลบออกจากหน่วยความจำในการอัปเดตรายวันครั้งต่อไป

หากไม่ได้ระบุเวลาหมดอายุเมื่อสร้าง CustomAudience เวลาหมดอายุจะ เป็นค่าเริ่มต้นเป็น 60 วันนับจากวันที่เปิดใช้งาน

วันหมดอายุสูงสุดคือ 60 วันนับจากวันที่เปิดใช้งานครั้งแรก

คิกรีเทิร์น
Instant การประทับเวลา Instant จะถูกตัดเป็นมิลลิวินาที จากนั้นที่กำหนดเอง ควรนำกลุ่มเป้าหมายออก ค่านี้อาจเป็น null

getName

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public String getName ()

ชื่อกลุ่มเป้าหมายที่กําหนดเองเป็นสตริงที่กําหนดเองที่เจ้าของและผู้ซื้อระบุไว้เมื่อสร้าง ของออบเจ็กต์ CustomAudience

คิกรีเทิร์น
String ชื่อสตริงของกลุ่มเป้าหมายที่กำหนดเอง ค่านี้ต้องไม่เป็น null

getTrustedBidData

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public TrustedBiddingData getTrustedBiddingData ()

ข้อมูลการเสนอราคาที่เชื่อถือได้ประกอบด้วย URI ที่ชี้ไปยังเซิร์ฟเวอร์ที่เชื่อถือได้สำหรับผู้ซื้อ ข้อมูลการเสนอราคา และรายการคีย์ที่ใช้ค้นหาเซิร์ฟเวอร์ โปรดทราบว่าคีย์เป็นตัวระบุที่กำหนดเอง ที่จะใช้ในการค้นหาเซิร์ฟเวอร์ที่เชื่อถือได้เท่านั้นสำหรับตรรกะการเสนอราคาของผู้ซื้อในระหว่างโฆษณา มากมาย

หากไม่ระบุไว้ CustomAudience จะไม่เข้าร่วมการเลือกโฆษณาจนกว่า ข้อมูลการเสนอราคาที่เชื่อถือได้จะแสดงผ่านการอัปเดตรายวันสำหรับกลุ่มเป้าหมายที่กำหนดเอง

คิกรีเทิร์น
TrustedBiddingData ออบเจ็กต์ TrustedBiddingData ที่มีการเสนอราคาที่เชื่อถือได้ของกลุ่มเป้าหมายที่กำหนดเอง ข้อมูล ค่านี้อาจเป็น null

getUserBidSignals

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public AdSelectionSignals getUserBiddingSignals ()

ผู้ซื้อเลือกสัญญาณการเสนอราคาของผู้ใช้ให้ผู้ซื้อได้ใช้โดยผู้ซื้อ JavaScript ในระหว่างการเลือกโฆษณาในสภาพแวดล้อมการดำเนินการที่แยกต่างหาก

หากสัญญาณการเสนอราคาของผู้ใช้ไม่ใช่ออบเจ็กต์ JSON ที่ถูกต้องที่สามารถใช้โดย JS ของผู้ซื้อ กลุ่มเป้าหมายที่กำหนดเองจะไม่มีสิทธิ์ในการเลือกโฆษณา

หากไม่ระบุไว้ CustomAudience จะไม่เข้าร่วมการเลือกโฆษณาจนกว่า สัญญาณการเสนอราคาของผู้ใช้จะแสดงผ่านการอัปเดตรายวันสำหรับกลุ่มเป้าหมายที่กำหนดเอง

คิกรีเทิร์น
AdSelectionSignals ออบเจ็กต์ AdSelectionSignals ที่แสดงสัญญาณการเสนอราคาของผู้ใช้สำหรับ กลุ่มเป้าหมายที่กำหนดเอง ค่านี้อาจเป็น null

แฮชโค้ด

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

แสดงผลแฮชของข้อมูลของออบเจ็กต์ CustomAudience

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

เขียนถึงพาร์เซล

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

แยกวัตถุนี้ลงในแปลงที่ดิน

พารามิเตอร์
dest Parcel: ค่านี้ต้องไม่เป็น null

flags int: แฟล็กเพิ่มเติมเกี่ยวกับวิธีเขียนออบเจ็กต์ อาจเป็น 0 หรือ Parcelable.PARCELABLE_WRITE_RETURN_VALUE ค่าเป็น 0 หรือชุดค่าผสมของ Parcelable.PARCELABLE_WRITE_RETURN_VALUE และ android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES