Privacy Sandbox มีข้อเสนอจำนวนหนึ่งเพื่อให้เปิดใช้ Use Case การโฆษณาได้โดยไม่ต้องติดตามข้ามเว็บไซต์ ช่วงทดลองใช้จากต้นทางเปิดโอกาสให้นักพัฒนาซอฟต์แวร์ประเมินและแสดงความคิดเห็นเกี่ยวกับเทคโนโลยีเว็บใหม่ๆ ผ่านการทดสอบในสถานการณ์จริง ในช่วงทดลองใช้จากต้นทางก่อนหน้านี้ เว็บไซต์สามารถทดสอบ กับ API แต่ละตัวได้ สำหรับ Topics, FLEDGE และ Attribution Reporting API เราจะเสนอช่วงทดลองใช้จากต้นทางเดียว ซึ่งช่วยให้เว็บไซต์ทำการทดสอบแบบรวมใน API ต่างๆ และสร้างวงจรโฆษณาแบบครบวงจรเวอร์ชันเริ่มต้นได้ API พร้อมใช้งานสำหรับการทดสอบใน Chrome 101 เบต้า ขึ้นไป Chrome 101 รุ่นเบต้ายังมีการอัปเดตการควบคุมของผู้ใช้ด้วยขณะที่เราปรับปรุงตัวเลือกการกำหนดค่าอย่างต่อเนื่อง
ในฐานะนักพัฒนาซอฟต์แวร์ คุณจะลงชื่อสมัครใช้ช่วงทดลองใช้จากต้นทางเดียวได้ ซึ่งจะทำให้คุณทดสอบใน Topics, FLEDGE และ Attribution Reporting API ได้ คู่มือนี้จะอธิบายขั้นตอนการกำหนดค่าเพื่อเข้าถึง API อธิบายวิธีตรวจสอบการกำหนดค่า และให้ทรัพยากรเพิ่มเติมสำหรับการทดสอบกับ API
ช่วงทดลองใช้จากต้นทางมีอะไรบ้าง
เป้าหมายของช่วงทดลองใช้จากต้นทางนี้คือการให้มีการทดสอบที่มีความหมายในทุกวงจรของโฆษณาในหลายเว็บไซต์ ช่วงทดลองใช้จากต้นทางจะมีสิ่งต่อไปนี้เพื่อให้ครอบคลุมเส้นทางนี้
- หัวข้อเพื่อดูและเข้าถึงหัวข้อของเบราว์เซอร์ผ่าน
document.browsingTopics() - FLEDGE เพื่อจัดการกลุ่มความสนใจของเบราว์เซอร์ รวมถึงการเสนอราคาและการเลือกโฆษณาตามกลุ่มเหล่านั้นและสัญญาณอื่นๆ
- ในช่วงทดลองใช้จากต้นทางนี้ FLEDGE พร้อมให้บริการบนเดสก์ท็อปและจะมีชุดย่อยของฟังก์ชันที่เสนอทั้งหมด โปรดอ่านรายละเอียดช่วงทดลองใช้ FLEDGE จากต้นทางเพื่อดูข้อมูลเพิ่มเติม
- เฟรมที่มีการปิดกั้นเพื่อแสดง URL แบบทึบของผู้ชนะการประมูลเพื่อแสดงโฆษณา FLEDGE
- Attribution Reporting เพื่อวัดและรายงานประสิทธิภาพตลอดวงจรโฆษณา
- ในฐานะส่วนหนึ่งของการรายงานการระบุแหล่งที่มา รายงานที่รวบรวมได้ต้องได้รับการประมวลผลและรวบรวมโดยบริการรวบรวมข้อมูลเพื่อสร้างรายงานสรุป เราจะเผยแพร่เครื่องมือและคำแนะนำเพิ่มเติม สำหรับการทดสอบช่วงทดลองใช้ในพื้นที่และจากต้นทางเร็วๆ นี้
- หากเคยเข้าร่วมช่วงทดลองใช้จากต้นทางก่อนหน้านี้สำหรับการรายงานการระบุแหล่งที่มา โปรดทราบว่าคุณจะต้องอัปเดตให้สอดคล้องกับการเปลี่ยนแปลงล่าสุดของ API ดูรายละเอียดได้ในคำแนะนำในการย้ายข้อมูล
แม้ว่าการตั้งค่านี้จะช่วยให้ทำการทดสอบแบบรวมใน API เหล่านี้ได้ทั้งหมด แต่คุณเลือกได้ว่าจะติดตั้งใช้งานในด้านใดมากหรือน้อยตามต้องการ
นักพัฒนาแอปจะลงชื่อสมัครช่วงทดลองใช้จากต้นทางได้อย่างไร
ลงทะเบียนเพื่อทดลองใช้ความเกี่ยวข้องและการวัดผลของ Privacy Sandbox ด้วยแท็ก HTML ต่อไปนี้ ให้ระบุโทเค็นการทดลองใช้ในทุกๆ หน้าเว็บที่คุณต้องการเรียกใช้โค้ด API
<meta>ในส่วน<head>ของหน้าระดับบนสุด:<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">- ส่วนหัว HTTP ในการตอบกลับของหน้าเว็บระดับบนสุด:
Origin-Trial: TOKEN_GOES_HERE
ฟังก์ชันการทำงานบางอย่างที่มีอยู่ในช่วงทดลองใช้จากต้นทางมีจุดประสงค์เพื่อใช้ในบริบทแบบข้ามเว็บไซต์ เช่น เมื่อคุณให้บริการในฐานะบุคคลที่สามในเว็บไซต์ระดับบนสุด หากจำเป็นต้องเปิดใช้ช่วงทดลองใช้จากต้นทางสำหรับบริบทเพิ่มเติมเหล่านี้ โปรดเลือกตัวเลือกสำหรับ "การจับคู่ของบุคคลที่สาม"
หากต้องการเปิดใช้ช่วงทดลองใช้จากต้นทางจาก JavaScript ของบุคคลที่สาม ให้แทรกแท็ก <meta> ในหน้าระดับบนสุด (เช่น หน้าของบุคคลที่หนึ่ง ไม่ใช่เนื้อหาของคุณเอง) จากสคริปต์ เช่น
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
ดูข้อมูลเพิ่มเติมได้ในคู่มือการเริ่มต้นใช้งานช่วงทดลองใช้จากต้นทางของ Chrome
นักพัฒนาแอปจะทดสอบภายในเครื่องอย่างไร
เอกสารประกอบสำหรับนักพัฒนาแอปแต่ละรายสำหรับ Topics, FLEDGE และการรายงานการระบุแหล่งที่มามีคําแนะนําเฉพาะเกี่ยวกับการทดสอบของนักพัฒนาแอปในพื้นที่สําหรับ API แต่ละรายการ API ไม่ได้เปิดอยู่โดยค่าเริ่มต้น และต้องเปิดใช้ด้วยแฟล็กเพื่อทำการทดสอบ
หากต้องการเปิดใช้ API สำหรับการทดสอบ คุณต้องทำดังนี้
- ใช้ Chrome 101 เบต้า ขึ้นไป
- FLEDGE ต้องใช้ Chrome เดสก์ท็อป
- API ไม่พร้อมใช้งานใน Chrome เวอร์ชัน iOS
- เปิดใช้ API โดยใช้แฟล็ก
chrome://flags/#privacy-sandbox-ads-apis- Flag นี้จะบังคับให้เปิด API เพื่อให้ทดสอบได้ง่ายขึ้น หากคุณต้องการจำลองผู้ใช้ช่วงทดลองใช้จากต้นทางที่มีสิทธิ์ซึ่งการตั้งค่าเพิ่มเติมของผู้ใช้ยังคงปิดใช้ API ได้ คุณควรเปิด Chrome โดยใช้แฟล็ก CLI ดังนี้
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs - โดย API แต่ละรายการอาจมีแฟล็กเพิ่มเติมสำหรับการกำหนดค่าที่ละเอียดยิ่งขึ้น โปรดอ่านรายละเอียดในคำแนะนำแต่ละรายการ
- แฟล็กอื่นๆ อาจขัดแย้งกับแฟล็กนี้ ดังนั้นให้พิจารณาตั้งค่าแฟล็กนี้ในกรณีที่คุณพบปัญหาเท่านั้น
- Flag นี้จะบังคับให้เปิด API เพื่อให้ทดสอบได้ง่ายขึ้น หากคุณต้องการจำลองผู้ใช้ช่วงทดลองใช้จากต้นทางที่มีสิทธิ์ซึ่งการตั้งค่าเพิ่มเติมของผู้ใช้ยังคงปิดใช้ API ได้ คุณควรเปิด Chrome โดยใช้แฟล็ก CLI ดังนี้
- เปิดใช้การทดลองใช้ Privacy Sandbox ในการตั้งค่า Chrome: การตั้งค่า >
ความปลอดภัยและความเป็นส่วนตัว > Privacy Sandbox และเข้าถึงได้ที่
chrome://settings/adPrivacyด้วย - เปิดใช้คุกกี้ของบุคคลที่สามในการตั้งค่า Chrome: การตั้งค่า >
ความปลอดภัยและความเป็นส่วนตัว ตั้งค่าคุกกี้และข้อมูลเว็บไซต์อื่นๆ เป็น "อนุญาตคุกกี้ทั้งหมด" หรือ "บล็อกคุกกี้ของบุคคลที่สามในโหมดไม่ระบุตัวตน" ซึ่งเข้าถึงได้ที่
chrome://settings/cookies - อยู่ในเซสชันการท่องเว็บมาตรฐาน อย่าใช้โหมดไม่ระบุตัวตน
นักพัฒนาแอปจะตรวจสอบได้อย่างไรว่ากำหนดค่าช่วงทดลองใช้จากต้นทางถูกต้อง
การแก้ปัญหาช่วงทดลองใช้จากต้นทางของ Chrome มีรายการตรวจสอบโดยละเอียดสำหรับตรวจสอบการกำหนดค่าช่วงทดลองใช้จากต้นทาง
เครื่องมือสำหรับนักพัฒนาเว็บแสดงสถานะการทดลองใช้จากต้นทางในแท็บแอปพลิเคชันใต้เฟรม
แม้ว่าช่วงทดลองใช้จากต้นทางจะแสดงเป็นใช้งานอยู่เท่านั้นสำหรับผู้ใช้ที่มีสิทธิ์ตามรายละเอียดด้านล่าง คุณยังใช้แฟล็กนักพัฒนาแอปเพื่อทดสอบกับเว็บไซต์เวอร์ชันที่ใช้งานจริงของคุณเองได้ด้วย
ผู้ใช้รายใดบ้างที่มีสิทธิ์ทดลองใช้จากต้นทาง
ตามการออกแบบ ช่วงทดลองใช้จากต้นทางมีไว้เพื่อใช้ในการเข้าชม Chrome โดยรวมจำนวนเล็กน้อยเท่านั้น ดังนั้นคุณควรคิดอยู่เสมอว่าแม้คุณจะเปิดใช้ช่วงทดลองใช้จากต้นทางในเว็บไซต์ แต่ผู้ใช้อาจไม่ได้เปิดใช้งาน API กลุ่มทดสอบที่ใช้งานอยู่ในช่วงทดลองใช้จากต้นทางจะเริ่มต้นกับผู้ใช้ในสัดส่วนต่ำ และมีแนวโน้มที่จะเพิ่มขึ้นเมื่อการทดลองดำเนินไปเรื่อยๆ โปรดทราบว่าเปอร์เซ็นต์ของผู้ใช้ Chrome ในการทดสอบอาจไม่ตรงกับเปอร์เซ็นต์ของผู้ใช้ที่เปิดใช้งานในเว็บไซต์ของคุณ
อย่างไรก็ตาม กลุ่มผู้ใช้ที่มีสิทธิ์ควรมีความสม่ำเสมอมากที่สุดเพื่อให้การทดสอบแบบรวมศูนย์ได้ทั่วเว็บไซต์ ตัวอย่างเช่น หากผู้ใช้มีสิทธิ์ทดลองใช้ต้นทางเมื่อดูโฆษณาในเว็บไซต์ของผู้เผยแพร่โฆษณาที่เข้าร่วม ผู้ใช้รายเดียวกันนี้ก็น่าจะมีสิทธิ์ทำ Conversion ในเว็บไซต์ของผู้ลงโฆษณาที่เข้าร่วม
ผู้ใช้ต้องมีคุณสมบัติดังนี้จึงจะมีสิทธิ์
- ใช้ Chrome 101 เบต้า ขึ้นไป
- FLEDGE ต้องใช้ Chrome เดสก์ท็อป
- ไม่มีช่วงทดลองใช้จากต้นทางใน Chrome เวอร์ชัน iOS
- ท่องเว็บในระหว่างระยะทดลองจากต้นทางที่ใช้งานอยู่
- เปิดใช้ช่วงทดลองใช้ Privacy Sandbox ผ่านการตั้งค่า > ความปลอดภัยและความเป็นส่วนตัว > Privacy Sandbox และเข้าถึงได้ผ่าน
chrome://settings/adPrivacy - เปิดใช้คุกกี้ของบุคคลที่สามผ่านการตั้งค่า > ความปลอดภัยและความเป็นส่วนตัว > คุกกี้และข้อมูลเว็บไซต์อื่นๆ ที่ตั้งค่าเป็น "อนุญาตคุกกี้ทั้งหมด" หรือ "บล็อกคุกกี้ของบุคคลที่สามในโหมดไม่ระบุตัวตน" ซึ่งเข้าถึงได้ผ่าน
chrome://settings/cookies - อยู่ในเซสชันการท่องเว็บมาตรฐานและไม่ใช่โหมดไม่ระบุตัวตน
- อยู่ในกลุ่มทดสอบที่ใช้งานอยู่ใน Chrome
ฟีเจอร์สำหรับนักพัฒนาซอฟต์แวร์ควรตรวจหาการรองรับ API อย่างไร
เช่นเดียวกับฟีเจอร์แพลตฟอร์มเว็บอื่นๆ คุณควรตรวจหาการรองรับฟีเจอร์ ก่อนที่จะใช้งาน
หัวข้อ
ตรวจสอบฟังก์ชัน browsingTopics() ใน document และนโยบายสิทธิ์](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature)
สำหรับ "browsing-topics"
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
หากต้องการเข้าร่วมกลุ่มความสนใจของโฆษณา ให้หาฟังก์ชัน joinAdInterestGroup ใน navigator และนโยบายสิทธิ์สำหรับ "join-ad-interest-group"
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
หากต้องการเรียกใช้การประมูล ให้ตรวจสอบฟังก์ชัน runAdAuction ใน navigator และนโยบายสิทธิ์สำหรับ "เรียกใช้โฆษณาประมูล"
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
การรายงานการระบุแหล่งที่มา
ตรวจหาออบเจ็กต์ attributionReporting ใน window และนโยบายสิทธิ์สำหรับ "การรายงานการระบุแหล่งที่มา"
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
นักพัฒนาแอปสามารถแสดงความคิดเห็นและรับการสนับสนุนได้จากที่ใด
หน้าภาพรวมความคิดเห็นจะแสดงรายละเอียดเส้นทางต่างๆ ในการแสดงความคิดเห็นเกี่ยวกับแง่มุมต่างๆ ของ Privacy Sandbox มีส่วนที่เจาะจงสำหรับ Topics, FLEDGE และ Attribution Reporting ซึ่งมีลิงก์แต่ละรายการสำหรับ API แต่ละรายการ
นอกจากนี้ เรายังมีการอัปเดตความคืบหน้าในซีรีส์ Privacy Sandbox อย่างสม่ำเสมอ ซึ่งให้สรุปข่าวสารสำคัญ