แก้ไขข้อบกพร่องในการรายงานสำหรับ Protected Audience

การรายงานการแก้ไขข้อบกพร่องของ Protected Audience ช่วยให้นักพัฒนาเทคโนโลยีโฆษณาประกาศการใช้งานจากระยะไกลได้ URL ที่จะได้รับคำขอ GET จากอุปกรณ์เมื่อชนะการประมูลหรือแพ้ ช่วงเวลานี้ เปิดใช้กรณีการใช้งานต่อไปนี้

  • รับรายงานผลการประมูลที่ชนะและแพ้
  • ทำความเข้าใจสาเหตุที่การประมูลหายไป เช่น ทำความเข้าใจว่าเป็นปัญหาหรือไม่ การเสนอราคาหรือการให้คะแนนการใช้สคริปต์ หรือปัญหาตรรกะหลัก
  • ค้นพบปัญหาเมื่ออัปเดตตรรกะ JavaScript

การรายงานการแก้ไขข้อบกพร่องระดับเหตุการณ์พร้อมให้ใช้งานสำหรับการทดสอบใน Privacy Sandbox การแสดงตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ 9. ระบบรองรับการรายงานการแก้ไขข้อบกพร่องในอุปกรณ์ทั้งหมดที่มีรหัสโฆษณา พร้อมใช้งาน

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการรายงานการแก้ไขข้อบกพร่องในช่วงทดลองใช้ FLEDGE จากต้นทางเดิมของ Chrome ข้อเสนอ

การใช้งาน

การรายงานการแก้ไขข้อบกพร่องถูกนำมาใช้ด้วย JavaScript API ต่อไปนี้ ทั้ง ซึ่งใช้อาร์กิวเมนต์สตริง URL ดังนี้

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

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

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

เทมเพลต ${winningBid} จะถูกแทนที่ด้วยค่าจริงหลังพารามิเตอร์ การประมูลเสร็จสมบูรณ์

ผู้ขายอาจส่งคืน rejectReason จากฟังก์ชัน scoreAds ของตนดังนี้

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

หากผู้ขายไม่ได้กำหนดเหตุผลการปฏิเสธ ระบบจะส่ง not-available แทน

ตัวแปร URL

ตัวแปรที่สามารถเพิ่มลงใน URL การแก้ไขข้อบกพร่อง จะตรงกับตัวแปร ใน Chrome (แต่ ${topLevelWinningBid} และ ${topLevelMadeWinningBid} ไม่พร้อมใช้งานเนื่องจากไม่มีแนวคิดของคอมโพเนนต์ การประมูลใน Android)

ชื่อตัวแปร คำอธิบาย
winningBid มูลค่าของราคาเสนอที่ชนะ
madeWinningBid ค่าบูลีนที่แสดงว่าผู้ซื้อของ ผู้ชมเป็นผู้เสนอราคาเสนอที่ชนะ ไม่ว่าจะโดยกลุ่มเป้าหมายที่กำหนดเองนี้ หรือกลุ่มเป้าหมายอื่น กลุ่มเป้าหมายที่กำหนดเองที่มีผู้ซื้อรายเดียวกัน
highestScoringOtherBid มูลค่าของราคาเสนอที่ได้คะแนนสูงสุดเป็นอันดับ 2 จาก สคริปต์ ScoreAd ของผู้ขาย โปรดทราบว่าราคานี้อาจไม่ใช่ราคาเสนอที่สูงเป็นอันดับสอง เนื่องจากคะแนนและราคาเสนออาจ เป็นอิสระจากกัน
madeHighestScoringOtherBid ค่าบูลีนที่แสดงว่าผู้ซื้อของกลุ่มเป้าหมายที่กำหนดเองนี้หรือไม่ ทำการเสนอราคา ${highestScoringOtherBid} ไม่ว่าจะโดย หรือกลุ่มเป้าหมายที่กำหนดเองอื่นๆ ที่มีผู้ซื้อรายเดียวกัน
rejectReason สตริงที่ผู้ขายกำหนดหรือไม่ก็ได้ ซึ่งอธิบายสาเหตุที่ผู้ขายปฏิเสธ สูงสุด อาจเป็นค่าใดก็ได้ต่อไปนี้

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

ข้อจำกัด

  • โฮสต์ URL ต้องตรงกับโดเมน Privacy Sandbox ที่ลงทะเบียนไว้ของคุณ
  • URL ต้องมีความยาวไม่เกิน 4, 096 อักขระ รวมโดเมนและ https:// คำนำหน้า และข้อมูลการประมูลที่แทนที่
  • ในรุ่นต่อๆ ไป ระบบจะส่งคำสั่ง ping สำหรับแก้ไขข้อบกพร่องเมื่อเชื่อมต่อกับ Wi-Fi เท่านั้น

ลักษณะการทำงานในอุปกรณ์

ในสภาพแวดล้อมของอุปกรณ์เคลื่อนที่ การปกป้องหน่วยความจำและการใช้งานเครือข่ายเป็นหัวใจสำคัญ ด้วยเหตุนี้ รายงานการแก้ไขข้อบกพร่องจึงเกิดขึ้นเป็นกลุ่ม

พร็อพเพอร์ตี้ของระบบต่อไปนี้จะควบคุมอัตราและขนาดของกลุ่ม ซึ่งสามารถ ปรับให้มีค่าต่ำลงสำหรับการพัฒนา:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

เวลาในการตอบสนองที่คาดไว้ของรายงานการแก้ไขข้อบกพร่องคือระหว่าง 15-60 นาทีหลังการประมูล เสร็จสมบูรณ์แล้ว

ไม่มีการรับประกันที่สมบูรณ์ของความสมบูรณ์ของรายงานแก้ไขข้อบกพร่อง หากอุปกรณ์ การรีบูตหรือกระบวนการ Adservices ขัดข้องก่อนที่จะมีการส่งการเรียกไปยังเซิร์ฟเวอร์ กิจกรรมเหล่านี้จะหายไป

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

สุดท้าย หากผู้ใช้ปิดใช้ AdId ระบบจะส่งรายงานการแก้ไขข้อบกพร่อง ช่วงเวลานี้ ไม่ได้ติดตั้งใช้งานในเวอร์ชันตัวอย่าง 9 สำหรับนักพัฒนาซอฟต์แวร์ แต่จะนํามาใช้ในอนาคต เวอร์ชันต่างๆ

ลักษณะการทำงานของเซิร์ฟเวอร์เทคโนโลยีโฆษณา

เซิร์ฟเวอร์เทคโนโลยีโฆษณาควรมีลักษณะต่อไปนี้สําหรับการรายงานการแก้ไขข้อบกพร่อง

  • อุปกรณ์จะส่งคำขอ GET ไปยังเซิร์ฟเวอร์ที่คุณระบุ forDebuggingOnly.* API
  • คำขอแต่ละรายการจะแสดงรายงานการแก้ไขข้อบกพร่องระดับเหตุการณ์ 1 รายการ ซึ่งประกอบด้วยการประมูลเพื่อแสดงโฆษณา 1 รายการ การชนะหรือแพ้การประมูล
  • คำขอแต่ละรายการไม่มีเนื้อความ ข้อมูลทั้งหมดอยู่ในพารามิเตอร์การค้นหา
  • เพย์โหลดการตอบสนองขนาดใหญ่อาจส่งผลเสียต่อประสิทธิภาพและการใช้ข้อมูล และ จะถูกละเว้น