ดูวิธีควบคุมการจัดการกลุ่มเป้าหมายโดยใช้นโยบายสิทธิ์หรือมอบสิทธิ์ให้บุคคลที่สามโดยการกำหนดค่า URL สิทธิ์ .well-known
ต้นทางของบริบทการเรียกใช้สำหรับ joinAdInterestGroup() ต้องตรงกับต้นทางของเจ้าของกลุ่มความสนใจ ดังนั้นจึงต้องเรียก joinAdInterestGroup() จาก iframe (เช่น จาก DSP) เว้นแต่ต้นทางของเจ้าของกลุ่มความสนใจจะตรงกับต้นทางของเอกสารปัจจุบัน (เช่น เว็บไซต์ที่มีกลุ่มความสนใจเป็นของตนเอง)
joinAdInterestGroup() ต้องได้รับสิทธิ์จาก
- เว็บไซต์ที่มีการเข้าชม
- เจ้าของกลุ่มความสนใจ
ซึ่งหมายความว่า malicious.example จะโทรหา joinAdInterestGroup() สำหรับกลุ่มความสนใจของ dsp.example.com ไม่ได้หาก dsp.example.com ไม่ให้สิทธิ์
สิทธิ์จากเว็บไซต์ที่เข้าชม
คุณให้สิทธิ์ได้จากต้นทางเดียวกันหรือข้ามต้นทางก็ได้
โดยค่าเริ่มต้น ระบบจะให้สิทธิ์สำหรับการเรียก joinAdInterestGroup() จากต้นทางเดียวกับเว็บไซต์ที่เข้าชม (กล่าวคือ มาจากต้นทางเดียวกับเฟรมระดับบนสุดของหน้าปัจจุบัน) เว็บไซต์สามารถใช้ส่วนหัวนโยบายสิทธิ์ join-ad-interest-group เพื่อปิดใช้การเรียกใช้ joinAdInterestGroup() ได้
การเรียกใช้ joinAdInterestGroup() แบบข้ามต้นทาง (ต้นทางที่ต่างจากหน้าปัจจุบัน) จะสำเร็จได้ก็ต่อเมื่อเว็บไซต์ที่กำลังเข้าชมมีนโยบายสิทธิ์ที่อนุญาตให้เรียกใช้ joinAdInterestGroup() จาก iframe แบบข้ามต้นทาง
สิทธิ์จากเจ้าของกลุ่มความสนใจ
การให้สิทธิ์เจ้าของกลุ่มความสนใจเป็นการให้สิทธิ์โดยปริยายโดยการเรียกใช้ joinAdInterestGroup() จาก iframe ที่มีต้นทางเดียวกันกับเจ้าของกลุ่มความสนใจ ตัวอย่างเช่น iframe ของ dsp.example.com จะเรียกใช้ joinAdInterestGroup() สำหรับกลุ่มความสนใจของ dsp.example.com ได้
โดยพื้นฐานแล้ว joinAdInterestGroup() สามารถเรียกใช้ในหน้าเว็บหรือ iframe ในโดเมนของเจ้าของ หรืออาจได้รับมอบสิทธิ์ไปยังโดเมนอื่นๆ ที่ระบุโดยใช้รายการที่ URL ของ .well-known
เมื่อเฟรมหนึ่งไปยังโดเมนหนึ่งเรียกใช้ joinAdInterestGroup(), leaveAdInterestGroup() หรือ clearOriginJoinedAdInterestGroups() สำหรับกลุ่มความสนใจที่มีเจ้าของรายอื่น เบราว์เซอร์จะดึงข้อมูล URL https://owner.domain/.well-known/interest-group/permissions/?origin=frame.origin โดยที่ owner.domain คือโดเมนที่เป็นเจ้าของกลุ่มความสนใจและ frame.origin เป็นต้นทางของเฟรม การดึงข้อมูลจะใช้โหมดข้อมูลรับรองแบบละเว้น โดยใช้คีย์พาร์ติชันเครือข่ายของเฟรมที่เรียกใช้เมธอด การดึงข้อมูลจะใช้โหมด Cors เพื่อหลีกเลี่ยงการรั่วไหลของข้อมูลข้ามต้นทางผ่าน Promise ที่แสดงผลโดยไม่คาดคิด การตอบกลับที่ดึงข้อมูลควรมีประเภท JSON MIME และอยู่ในรูปแบบดังนี้
{ "joinAdInterestGroup": true/false,
"leaveAdInterestGroup": true/false
}
เพื่อระบุว่าต้นทางในเส้นทางมีสิทธิ์เข้าร่วมหรือออกจากกลุ่มความสนใจที่เป็นของโดเมนที่มีการส่งคำขอไปหรือไม่ ระบบจะถือว่าสิทธิ์ที่ขาดหายไปเป็นเท็จ เนื่องจากการเรียกใช้ navigator.joinAdInterestGroup() ด้วยค่า lifetimeMs เท่ากับ 0 จะออกจากกลุ่มความสนใจ joinAdInterestGroup: true ยังอนุญาตให้ต้นทางเรียกใช้ navigator.leaveAdInterestGroup() ได้ด้วย แม้ว่าจะไม่มี leaveadInterestGroup หรือตั้งค่าเป็น "เท็จ" ก็ตาม โปรดทราบว่าทั้ง leaveAdInterestGroup() และ clearOriginJoinedAdInterestGroups() จะต้องตรวจสอบสิทธิ์ leaveAdInterestGroup