ดูวิธีอัปเดตข้อมูลกลุ่มเป้าหมายโดยกำหนดค่า 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 ยังให้รายละเอียดเกี่ยวกับการรองรับและข้อจำกัดต่างๆ ของฟีเจอร์ด้วย