กำหนดข้อมูลกลุ่มเป้าหมาย

ดูวิธีกำหนดกลุ่มเป้าหมายโดยการสร้างกลุ่มความสนใจโดยใช้ 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

joinAdInterestGroup()

แพลตฟอร์มฝั่งซื้อ (DSP) ของผู้ลงโฆษณาหรือผู้ลงโฆษณาเรียก navigator.joinAdInterestGroup() เพื่อขอให้เบราว์เซอร์เพิ่มกลุ่มความสนใจลงในรายการสมาชิกของเบราว์เซอร์

ต้นทางของบริบทการเรียกใช้สำหรับ joinAdInterestGroup() ต้องตรงกับต้นทางของเจ้าของกลุ่มความสนใจ ดังนั้นจึงต้องเรียก joinAdInterestGroup() จาก iframe (เช่น จาก DSP) เว้นแต่ต้นทางของเจ้าของกลุ่มความสนใจจะตรงกับต้นทางของเอกสารปัจจุบัน (เช่น เว็บไซต์ที่มีกลุ่มความสนใจเป็นของตนเอง)

joinAdInterestGroup() ต้องได้รับสิทธิ์จาก

ซึ่งหมายความว่า malicious.example จะโทรหา joinAdInterestGroup() สำหรับกลุ่มความสนใจของ dsp.example.com ไม่ได้หาก dsp.example.com ไม่ให้สิทธิ์

สิทธิ์จากเว็บไซต์ที่เข้าชม

คุณให้สิทธิ์ได้จากต้นทางเดียวกันหรือข้ามต้นทางก็ได้ โดยค่าเริ่มต้น ระบบจะให้สิทธิ์สำหรับการเรียก joinAdInterestGroup() จากต้นทางเดียวกับเว็บไซต์ที่เข้าชม (กล่าวคือ มาจากต้นทางเดียวกับเฟรมระดับบนสุดของหน้าปัจจุบัน)

ตัวอย่างการใช้

ต่อไปนี้เป็นตัวอย่างวิธีที่ผู้ชมอาจกำหนดกลุ่มความสนใจและขอให้เบราว์เซอร์เข้าร่วมกลุ่ม

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);

ออบเจ็กต์ interestGroup ที่ส่งไปยังฟังก์ชันต้องมีขนาดไม่เกิน 50 kiB มิฉะนั้นการเรียกใช้จะล้มเหลว พารามิเตอร์ที่ 2 ระบุระยะเวลาของกลุ่มความสนใจ ซึ่งไม่เกิน 30 วัน การเรียกใช้อย่างต่อเนื่องจะเขียนทับค่าที่จัดเก็บไว้ก่อนหน้านี้

พร็อพเพอร์ตี้ที่จำเป็น

พร็อพเพอร์ตี้ที่จำเป็นสำหรับกลุ่มความสนใจมีเพียง owner และ name ดังนี้

พร็อพเพอร์ตี้ ตัวอย่าง บทบาท
owner https://dsp.example ต้นทางของเจ้าของกลุ่มความสนใจ
name custom-bikes ชื่อกลุ่มความสนใจ

พร็อพเพอร์ตี้ที่ไม่บังคับ

พร็อพเพอร์ตี้ที่เหลือเป็นคุณสมบัติที่ไม่บังคับดังนี้

biddingLogicUrl1, 2
ตัวอย่าง: https://dsp.example/bid/custom-bikes/bid.js
บทบาท: URL สำหรับการเสนอราคาที่ JavaScript ทำงานใน Worklet
biddingWasmHelperUrl1, 2
ตัวอย่าง: https://dsp.example/bid/custom-bikes/bid.wasm
บทบาท: URL ของโค้ด WebAssembly ที่มาจาก biddingLogicUrl
updateUrl2
ตัวอย่าง: https://dsp.example/bid/custom-bikes/update
บทบาท: URL ที่แสดงผล JSON เพื่ออัปเดตแอตทริบิวต์กลุ่มความสนใจ (โปรดดูหัวข้ออัปเดตข้อมูลกลุ่มเป้าหมายและรีเฟรชโฆษณา)
trustedBiddingSignalsUrl2
ตัวอย่าง: https://dsp.example/trusted/bidding-signals
บทบาท: URL ฐานสำหรับคำขอคีย์-ค่าที่ส่งไปยังบริการจัดการคีย์/ค่าที่เชื่อถือได้ของผู้เสนอราคา
trustedBiddingSignalsKeys
ตัวอย่าง: ['key1', 'key2' ...]
บทบาท: คีย์สำหรับคำขอไปยังบริการจัดการคีย์-ค่าที่เชื่อถือได้
userBiddingSignals
ตัวอย่าง: {...}
บทบาท: ข้อมูลเมตาเพิ่มเติมที่เจ้าของสามารถใช้ในระหว่างการเสนอราคา
ads1
ตัวอย่าง: [bikeAd1, bikeAd2, bikeAd3]
บทบาท: โฆษณาที่อาจแสดงผลสำหรับกลุ่มความสนใจนี้
adComponents
ตัวอย่าง: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]
บทบาท: คอมโพเนนต์สำหรับโฆษณาที่ประกอบด้วยหลายชิ้น

1 พร็อพเพอร์ตี้ biddingLogicUrl และ ads เป็นพร็อพเพอร์ตี้ที่ไม่บังคับ แต่จำเป็นต้องเข้าร่วมการประมูล อาจมีกรณีการใช้งานสำหรับการสร้างกลุ่มความสนใจที่ไม่มีพร็อพเพอร์ตี้เหล่านี้ ตัวอย่างเช่น เจ้าของกลุ่มความสนใจอาจต้องการเพิ่มเบราว์เซอร์ลงในกลุ่มความสนใจสำหรับแคมเปญที่ยังไม่ได้ทำงานหรือสำหรับการใช้งานอื่นๆ ในอนาคต หรืออาจใช้งบประมาณการโฆษณาหมดชั่วคราว

2 ในการใช้งาน Protected Audience API ในปัจจุบัน biddingLogicUrl, biddingWasmHelperUrl, updateUrl และ trustedBiddingSignalsUrl ต้องมีต้นทางเดียวกันกับเจ้าของ ซึ่งอาจไม่ใช่ข้อจำกัดระยะยาว และ URL ads และ adComponents ไม่มีข้อจำกัดดังกล่าว

ระบุโฆษณาสำหรับกลุ่มความสนใจ

ออบเจ็กต์ ads และ adComponents ประกอบด้วย URL สำหรับครีเอทีฟโฆษณา และข้อมูลเมตาที่กำหนดเองซึ่งใช้ได้ขณะเสนอราคา (ไม่บังคับ)

เช่น

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

leaveAdInterestGroup()

เจ้าของกลุ่มความสนใจส่งคำขอให้นำเบราว์เซอร์ออกจากกลุ่มความสนใจได้ เบราว์เซอร์จะนำกลุ่มความสนใจออกจากรายการสมาชิก

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

หากผู้ใช้กลับไปที่เว็บไซต์ที่ขอให้เบราว์เซอร์เพิ่มกลุ่มความสนใจ เจ้าของกลุ่มความสนใจจะเรียกใช้ฟังก์ชัน navigator.leaveAdInterestGroup() เพื่อขอให้เบราว์เซอร์นำกลุ่มความสนใจออกได้

โค้ดของโฆษณายังสามารถเรียกฟังก์ชันนี้สำหรับกลุ่มความสนใจของโฆษณาได้ด้วย

คำถามที่พบบ่อย

จำนวนกลุ่มความสนใจสูงสุดต่อเจ้าของกลุ่มสำหรับผู้ใช้ 1 รายคือเท่าใด

Chrome อนุญาตให้มีกลุ่มความสนใจได้สูงสุด 1,000 กลุ่มต่อเจ้าของ 1 ราย และเจ้าของกลุ่มความสนใจสูงสุด 1,000 ราย ขีดจำกัดเหล่านี้มีไว้เพื่อเป็นแนวกันกระแทก ไม่ใช่การใช้งานตามปกติ

ฉันจะเพิ่มจำนวนโฆษณาตามกลุ่มความสนใจที่ตรงตามเกณฑ์ K-anon ให้สูงสุดได้อย่างไร

ดังที่คำอธิบายแบบสาธารณะระบุไว้ เนื่องจากกลุ่มความสนใจกลุ่มหนึ่งสามารถมีโฆษณาที่เป็นไปได้หลายรายการที่อาจแสดงได้ กลุ่มจึงจะมีโอกาสเสนอราคาใหม่ให้โฆษณาอีกรายการหนึ่งเพื่อทำหน้าที่เป็น "โฆษณาสำรอง" เมื่อใดก็ตามที่ตัวเลือกที่ต้องการมากที่สุดอยู่ต่ำกว่าเกณฑ์ ซึ่งหมายความว่าโฆษณาพิเศษขนาดเล็กที่ยังคงต่ำกว่าเกณฑ์ k-anonymity อาจยังเลือกเข้าร่วมการประมูลได้ และกลุ่มความสนใจของกลุ่มโฆษณานี้อาจกลับไปใช้โฆษณาแบบทั่วไปได้จนกว่าโฆษณาเฉพาะทางจะมีกลุ่มเป้าหมายขนาดใหญ่เพียงพอ

ในแง่ของกลยุทธ์ คุณอาจพิจารณาสิ่งต่อไปนี้

  • หากต้องการให้โฆษณาใหม่เริ่มแสดง ก็เพียงแค่เริ่มเสนอราคาสำหรับโฆษณานั้นๆ ในกรณีที่คุณต้องการให้โฆษณาแสดง คุณไม่จำเป็นต้องดำเนินการใดๆ เพิ่มเติม
  • คุณสามารถมีโฆษณาสำรองไว้ใช้เมื่อโฆษณาใหม่ไม่ใช่ K-anon มีความเสี่ยงที่ตัวโฆษณาสำรองของคุณไม่ใช่ K-anon ดังนั้นคุณอาจลองเสนอราคาด้วยโฆษณาสำรองไปก่อนได้ในบางครั้ง เช่น อาจเป็นเช่นนี้ 1% ของเวลาทั้งหมด เช่น ให้อยู่ในระดับที่ดีเพื่อให้แน่ใจว่าคุณคาดหวังว่าวิดีโอสำรองจะสูงกว่าเกณฑ์

เมื่อเร็วๆ นี้มีการพูดคุยเกี่ยวกับวิธีอื่นๆ ที่สามารถนำมาใช้งานได้ ดังนั้นหากคุณมีกรณีการใช้งานที่กลไกนี้อาจก่อให้เกิดปัญหา ก็ให้มีส่วนร่วมในการสนทนาสาธารณะเกี่ยวกับวิธีต่างๆ ในการปรับปรุง API

ข้อมูลอ้างอิงทั้งหมดของ Protected Audience API

มีคู่มืออ้างอิง API ดังต่อไปนี้

ตัวอธิบาย Protected Audience API ยังให้รายละเอียดเกี่ยวกับการรองรับและข้อจำกัดต่างๆ ของฟีเจอร์ด้วย