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

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