อัปเดตข้อมูลกลุ่มเป้าหมายและรีเฟรชโฆษณา

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