ดูวิธีอัปเดตข้อมูลกลุ่มเป้าหมายโดยการกําหนดค่า URL อัปเดตสําหรับกลุ่มความสนใจของ Protected Audience API อ่านคู่มือนักพัฒนาซอฟต์แวร์เพื่อดู Protected Audience API ตลอดอายุการใช้งาน และดูข้อเสนอเชิงลึกเกี่ยวกับวิธีที่เบราว์เซอร์บันทึกกลุ่มความสนใจได้จากคำอธิบายสำหรับ Protected Audience API
หากคุณไม่ใช่นักพัฒนาซอฟต์แวร์ ดูภาพรวมของ Protected Audience API
กลุ่มความสนใจของ Protected Audience API
กลุ่มความสนใจของ Protected Audience API คือกลุ่มคนที่มีความสนใจร่วมกัน ซึ่งสอดคล้องกับรายการรีมาร์เก็ตติ้ง กลุ่มความสนใจของ Protected Audience API ทุกกลุ่มจะมีเจ้าของ
เจ้าของกลุ่มความสนใจจะทำหน้าที่เป็นผู้ซื้อในการประมูลเพื่อแสดงโฆษณา Protected Audience API เบราว์เซอร์จะจัดเก็บข้อมูลการเป็นสมาชิกกลุ่มความสนใจไว้ในอุปกรณ์ของผู้ใช้ และจะไม่แชร์กับผู้ให้บริการเบราว์เซอร์หรือผู้อื่น
ฟังก์ชัน API
ตัวอย่างการใช้
ต่อไปนี้คือตัวอย่างจากคำแนะนำเกี่ยวกับวิธีกำหนดข้อมูลกลุ่มเป้าหมายซึ่งแสดงวิธีสร้างกลุ่มความสนใจและขอให้เบราว์เซอร์เข้าร่วมกลุ่ม
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
updateUrl
ระบุ URL ที่แสดงผล JSON เพื่ออัปเดตแอตทริบิวต์กลุ่มความสนใจ ซึ่งต้องมีต้นทางเดียวกันกับ owner
อัปเดตแอตทริบิวต์
updateUrl
ระบุเว็บเซิร์ฟเวอร์ที่แสดงผลพร็อพเพอร์ตี้กลุ่มความสนใจที่กำหนด JSON ซึ่งสอดคล้องกับออบเจ็กต์กลุ่มความสนใจที่ส่งไปยัง joinAdInterestGroup()
การทำเช่นนี้จะช่วยให้เจ้าของกลุ่มอัปเดตแอตทริบิวต์ของกลุ่มความสนใจได้เป็นระยะๆ ในการใช้งานปัจจุบัน แอตทริบิวต์ต่อไปนี้สามารถเปลี่ยนแปลงได้
biddingLogicUrl
biddingWasmHelperUrl
trustedBiddingSignalsUrl
trustedBiddingSignalsKeys
ads
priority
ระบบจะไม่เขียนทับช่องใดๆ ที่ไม่ได้ระบุใน JSON โดยจะอัปเดตเฉพาะช่องที่ระบุใน JSON เท่านั้น ในขณะที่การเรียกใช้ navigator.joinAdInterestGroup()
จะเขียนทับกลุ่มความสนใจที่มีอยู่
การอัปเดตเป็นการดำเนินการที่ดีที่สุด แต่อาจล้มเหลวได้ภายใต้เงื่อนไขต่อไปนี้
- ระยะหมดเวลาของคำขอเครือข่าย (ปัจจุบันอยู่ที่ 30 วินาที)
- เครือข่ายล้มเหลวอื่นๆ
- แยกวิเคราะห์ JSON ไม่สำเร็จ
ระบบจำกัดอัตราการอัปเดตไว้ที่ไม่เกิน 1 รายการต่อวัน
คุณยกเลิกการอัปเดตได้หากใช้เวลาอัปเดตที่ต่อเนื่องนานเกินไป แม้จะไม่ได้จำกัดอัตราการอัปเดตที่ถูกยกเลิก (ที่เหลืออยู่) ระบบจะพยายามอัปเดตไม่สำเร็จเนื่องจากข้อผิดพลาดเกี่ยวกับเครือข่ายใหม่หลังจากผ่านไป 1 ชั่วโมง และจะลองเชื่อมต่ออีกครั้งทันทีหากขาดการเชื่อมต่ออินเทอร์เน็ต
อัปเดตด้วยตนเอง
คุณทริกเกอร์การอัปเดตกลุ่มความสนใจที่ต้นทางของเฟรมปัจจุบันเป็นเจ้าของได้โดยใช้ navigator.updateAdInterestGroups()
การจำกัดอัตราคำขอจะป้องกันไม่ให้มีการอัปเดตบ่อยเกินไป: การเรียก navigator.updateAdInterestGroups()
ซ้ำจะไม่ดำเนินการใดๆ จนกว่าช่วงเวลาจำกัดของอัตรา (ปัจจุบันคือ 1 วัน) จะผ่านไปแล้ว
ระบบจะรีเซ็ตขีดจำกัดของอัตราหากมีการเรียก navigator.joinAdInterestGroup()
อีกครั้งสำหรับกลุ่มความสนใจ owner
และ name
เดียวกัน
การอัปเดตอัตโนมัติ
กลุ่มความสนใจทั้งหมดที่โหลดสำหรับการประมูลจะอัปเดตโดยอัตโนมัติหลังจากการประมูลเสร็จสิ้น โดยขึ้นอยู่กับขีดจำกัดอัตราเดียวกับการอัปเดตด้วยตนเอง
สำหรับเจ้าของแต่ละรายที่มีกลุ่มความสนใจอย่างน้อย 1 กลุ่มที่เข้าร่วมการประมูล จะมีการเรียก navigator.updateAdInterestGroups()
จาก iframe ที่มีต้นทางตรงกับเจ้าของรายดังกล่าว
ข้อมูลอ้างอิงของ Protected Audience API ทั้งหมด
มีคู่มืออ้างอิง API ดังต่อไปนี้
- คู่มือนักพัฒนาซอฟต์แวร์สำหรับ Protected Audience API
- คู่มือผู้ซื้อโฆษณาสําหรับกลุ่มความสนใจและการสร้างราคาเสนอของ Protected Audience
- คู่มือสำหรับผู้ขายโฆษณาเกี่ยวกับการประมูลเพื่อแสดงโฆษณาใน Protected Audience
- คู่มือการรายงานผลการประมูล
- แนวทางปฏิบัติแนะนำสำหรับ Protected Audience เวลาในการตอบสนองในการประมูลเพื่อแสดงโฆษณา
- แก้ปัญหา Protected Audience
ตัวอธิบาย Protected Audience API ยังให้รายละเอียดเกี่ยวกับการรองรับและข้อจำกัดต่างๆ ของฟีเจอร์ด้วย