ดูวิธีกำหนดกลุ่มเป้าหมายโดยการสร้างกลุ่มความสนใจโดยใช้ 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 |
ชื่อกลุ่มความสนใจ |
พร็อพเพอร์ตี้ที่ไม่บังคับ
พร็อพเพอร์ตี้ที่เหลือเป็นคุณสมบัติที่ไม่บังคับดังนี้
biddingLogicUrl
1, 2- ตัวอย่าง:
https://dsp.example/bid/custom-bikes/bid.js
- บทบาท: URL สำหรับการเสนอราคาที่ JavaScript ทำงานใน Worklet
biddingWasmHelperUrl
1, 2- ตัวอย่าง:
https://dsp.example/bid/custom-bikes/bid.wasm
- บทบาท: URL ของโค้ด WebAssembly ที่มาจาก
biddingLogicUrl
updateUrl
2- ตัวอย่าง:
https://dsp.example/bid/custom-bikes/update
- บทบาท: URL ที่แสดงผล JSON เพื่ออัปเดตแอตทริบิวต์กลุ่มความสนใจ (โปรดดูหัวข้ออัปเดตข้อมูลกลุ่มเป้าหมายและรีเฟรชโฆษณา)
trustedBiddingSignalsUrl
2- ตัวอย่าง:
https://dsp.example/trusted/bidding-signals
- บทบาท: URL ฐานสำหรับคำขอคีย์-ค่าที่ส่งไปยังบริการจัดการคีย์/ค่าที่เชื่อถือได้ของผู้เสนอราคา
trustedBiddingSignalsKeys
- ตัวอย่าง:
['key1', 'key2' ...]
- บทบาท: คีย์สำหรับคำขอไปยังบริการจัดการคีย์-ค่าที่เชื่อถือได้
userBiddingSignals
- ตัวอย่าง:
{...}
- บทบาท: ข้อมูลเมตาเพิ่มเติมที่เจ้าของสามารถใช้ในระหว่างการเสนอราคา
ads
1- ตัวอย่าง:
[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 开发者指南。
- 有关 Protected Audience 兴趣群体和出价生成的广告买方指南。
- Protected Audience 广告竞价广告卖方指南。
- 关于报告竞价结果的指南
- Protected Audience 广告竞价延迟时间方面的最佳实践
- 对 Protected Audience 进行问题排查
Protected Audience API 说明信息还详细介绍了功能支持和限制条件。