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

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