ดูวิธีกำหนดกลุ่มเป้าหมายโดยการสร้างกลุ่มความสนใจโดยใช้ 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 มิฉะนั้นการเรียกใช้จะไม่สำเร็จ พารามิเตอร์ที่สองระบุระยะเวลาของกลุ่มความสนใจ ซึ่งจำกัดไว้ที่ 30 วัน การเรียกแบบต่อเนื่องจะเขียนทับค่าที่จัดเก็บไว้ก่อนหน้านี้
พร็อพเพอร์ตี้ที่จำเป็น
พร็อพเพอร์ตี้ที่จำเป็นสำหรับกลุ่มความสนใจมีเพียง owner
และ name
เท่านั้น ได้แก่
พร็อพเพอร์ตี้ | ตัวอย่าง | บทบาท |
---|---|---|
owner |
https://dsp.example |
ต้นทางของเจ้าของกลุ่มความสนใจ |
name |
custom-bikes |
ชื่อกลุ่มความสนใจ |
พร็อพเพอร์ตี้ที่ไม่บังคับ
พร็อพเพอร์ตี้ที่เหลือเป็นตัวเลือกที่ไม่บังคับ ดังนี้
biddingLogicUrl
1, 2- ตัวอย่าง:
https://dsp.example/bid/custom-bikes/bid.js
- บทบาท: URL สำหรับการเสนอราคา JavaScript กำลังทำงานในเวิร์กเล็ต
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 มีความเสี่ยงอยู่บ้างที่โฆษณาสำรองของคุณจะไม่เป็นอุปกรณ์สาธารณะ ดังนั้นบางครั้งคุณจึงอาจลองเสนอราคาโดยใช้โฆษณาสำรองตั้งแต่แรก โดยอาจทำเช่นนี้ 1% จากทั้งหมด เช่น หากอยู่ในระดับที่ดีเพื่อให้แน่ใจว่าคุณคาดหวังให้วิดีโอสำรองอยู่สูงกว่าเกณฑ์
เมื่อเร็วๆ นี้มีการพูดคุยเกี่ยวกับวิธีอื่นๆ ที่จะทำงานได้ ดังนั้นหากคุณมีกรณีการใช้งานที่อาจทำให้เกิดปัญหา ให้พูดคุยกับสาธารณะต่อไปเกี่ยวกับวิธีการปรับปรุง API
ข้อมูลอ้างอิงของ Protected Audience API ทั้งหมด
มีคู่มืออ้างอิง API ดังต่อไปนี้
- คู่มือนักพัฒนาซอฟต์แวร์สำหรับ Protected Audience API
- คู่มือผู้ซื้อโฆษณาสําหรับกลุ่มความสนใจและการสร้างราคาเสนอของ Protected Audience
- คู่มือสำหรับผู้ขายโฆษณาเกี่ยวกับการประมูลเพื่อแสดงโฆษณาใน Protected Audience
- คู่มือการรายงานผลการประมูล
- แนวทางปฏิบัติแนะนำสำหรับ Protected Audience เวลาในการตอบสนองในการประมูลเพื่อแสดงโฆษณา
- แก้ปัญหา Protected Audience
ตัวอธิบาย Protected Audience API ยังให้รายละเอียดเกี่ยวกับการรองรับและข้อจำกัดต่างๆ ของฟีเจอร์ด้วย