AdSelectionConfig.Builder

public static final class AdSelectionConfig.Builder
extends Object

java.lang.Object
android.adservices.adselection.AdSelectionConfig.Builder


เครื่องมือสร้างสำหรับออบเจ็กต์ AdSelectionConfig

สรุป

ช่างก่อสร้างสาธารณะ

Builder()

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

AdSelectionConfig build()

สร้างอินสแตนซ์ AdSelectionConfig

AdSelectionConfig.Builder setAdSelectionSignals(AdSelectionSignals adSelectionSignals)

ตั้งค่าสัญญาณที่มอบให้ผู้ซื้อระหว่างการสร้างราคาเสนอการเลือกโฆษณา

AdSelectionConfig.Builder setCustomAudienceBuyers(List<AdTechIdentifier> customAudienceBuyers)

ตั้งค่ารายชื่อผู้ซื้อที่อนุญาต

AdSelectionConfig.Builder setDecisionLogicUri(Uri decisionLogicUri)

ตั้งค่า URI ที่ใช้ในการดึงตรรกะการตัดสินใจสำหรับใช้ในกระบวนการเลือกโฆษณา

AdSelectionConfig.Builder setPerBuyerSignals(Map<AdTechIdentifierAdSelectionSignals> perBuyerSignals)

ตั้งค่าสัญญาณจากผู้ซื้อแต่ละรายในระหว่างการเลือกโฆษณา

AdSelectionConfig.Builder setSeller(AdTechIdentifier seller)

ตั้งค่าตัวระบุผู้ขาย

AdSelectionConfig.Builder setSellerSignals(AdSelectionSignals sellerSignals)

กำหนดสัญญาณที่ใช้แก้ไขผลการเลือกโฆษณา

AdSelectionConfig.Builder setTrustedScoringSignalsUri(Uri trustedScoringSignalsUri)

ตั้งค่าปลายทาง URI ของสัญญาณที่เชื่อถือได้ฝั่งขายซึ่งจะแสดงแบบเรียลไทม์สำหรับครีเอทีฟโฆษณาที่เฉพาะเจาะจง ที่ดึงข้อมูลมาได้

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

ช่างก่อสร้างสาธารณะ

นักสร้าง

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

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

บิลด์

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

สร้างอินสแตนซ์ AdSelectionConfig

คิกรีเทิร์น
AdSelectionConfig ค่านี้ต้องไม่เป็น null

การขว้าง
NullPointerException หากมีพารามิเตอร์ที่จำเป็นเป็นค่าว่าง

setAdSelectionSignals

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

ตั้งค่าสัญญาณที่มอบให้ผู้ซื้อระหว่างการสร้างราคาเสนอการเลือกโฆษณา

หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น JSON ที่ว่างเปล่า

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getAdSelectionSignals()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null

setCustomAudienceBuyers

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

ตั้งค่ารายชื่อผู้ซื้อที่อนุญาต

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getCustomAudienceBuyers()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null

Set DecisionLogicUri

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

ตั้งค่า URI ที่ใช้ในการดึงตรรกะการตัดสินใจสำหรับใช้ในกระบวนการเลือกโฆษณา ผลการตัดสิน URI อาจเป็นสคีมาใดก็ได้ใน 2 แบบต่อไปนี้

  • HTTPS: HTTPS URI ต้องเป็น URI ที่สมบูรณ์ที่โฮสต์ตรงกับ seller
  • สร้างการเลือกโฆษณาไว้ล่วงหน้าแล้ว: URI บริการการเลือกโฆษณาใช้รูปแบบ ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters> FLEDGE จะสร้างสคริปต์ JS ที่เหมาะสมโดยไม่ต้องใช้การเรียกเครือข่าย

    สคริปต์ที่สร้างไว้ล่วงหน้าที่ใช้ได้มีดังนี้

    • highest-bid-wins สำหรับ scoreAds และ reportResult: JS นี้จะเลือกโฆษณาที่มีราคาเสนอสูงสุดสำหรับการทำคะแนน สำหรับ การรายงาน URI ที่กำหนดจะมีพารามิเตอร์เป็น render_uri และ bid ต้องมีพารามิเตอร์ด้านล่างเพื่อใช้ที่สร้างไว้ล่วงหน้านี้
      • reportingUrl: URI การรายงานพื้นฐานที่จะ ทำให้เกิดพารามิเตอร์ในภายหลังด้วย render_uri และ bid

      เช่น หาก URL การรายงานพื้นฐานคือ "https://www.ssp.com" จากนั้น ad-selection-prebuilt://ad-selection/highest-bid-wins/?reportingUrl=https://www.ssp.com

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getDecisionLogicUri()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null

setPerBuyerSignals

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย
public AdSelectionConfig.Builder setPerBuyerSignals (Map<AdTechIdentifierAdSelectionSignals> perBuyerSignals)

ตั้งค่าสัญญาณจากผู้ซื้อแต่ละรายในระหว่างการเลือกโฆษณา

หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็นแผนที่ว่างเปล่า

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getPerBuyerSignals()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null

setSeller

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

ตั้งค่าตัวระบุผู้ขาย

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getSeller()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null

setSellerSignals

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

กำหนดสัญญาณที่ใช้แก้ไขผลการเลือกโฆษณา

หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น JSON ที่ว่างเปล่า

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getSellerSignals()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null

ตั้งค่าการให้คะแนนที่เชื่อถือได้Uri

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

ตั้งค่าปลายทาง URI ของสัญญาณที่เชื่อถือได้ฝั่งขายซึ่งจะแสดงแบบเรียลไทม์สำหรับครีเอทีฟโฆษณาที่เจาะจง ที่ดึงข้อมูลมาได้

หากผ่านการตรวจสอบ Uri#EMPTY ระบบจะข้ามการเรียกใช้เครือข่ายและจะส่ง AdSelectionSignals.EMPTY ไปยังการเลือกโฆษณา

ดูรายละเอียดเพิ่มเติมได้ที่ AdSelectionConfig.getTrustedScoringSignalsUri()

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

คิกรีเทิร์น
AdSelectionConfig.Builder ค่านี้ต้องไม่เป็น null