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

ดูวิธีระบุกลุ่มเป้าหมายโดยการสร้างกลุ่มความสนใจโดยใช้ 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
Role: 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,000 ราย ขีดจำกัดเหล่านี้มีไว้เพื่อเป็นแนวทาง ไม่ใช่เพื่อใช้ในการปฏิบัติงานตามปกติ

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

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

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

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

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

การอ้างอิง Protected Audience API ทั้งหมด

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

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