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

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

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

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

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

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

การใช้งาน

การใช้การรายงานข้อบกพร่องจะใช้ JavaScript API ต่อไปนี้ ซึ่งทั้ง 2 รายการใช้อาร์กิวเมนต์สตริง 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)

ข้อจำกัด

• โฮสต์ 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
• คําขอแต่ละรายการแสดงรายงานการแก้ไขข้อบกพร่องระดับเหตุการณ์เดียว ซึ่งได้แก่ การประมูลโฆษณาครั้งเดียวที่ชนะหรือการประมูลโฆษณาครั้งเดียวที่แพ้
• คําขอแต่ละรายการไม่มีเนื้อหา ข้อมูลทั้งหมดอยู่ในพารามิเตอร์การค้นหา
• เพย์โหลดการตอบกลับขนาดใหญ่อาจส่งผลเสียต่อประสิทธิภาพและการใช้อินเทอร์เน็ต และจะไม่ได้รับการพิจารณา