ทดสอบ API ความเกี่ยวข้องและการวัดผลของโฆษณา Privacy Sandbox

Privacy Sandbox มีชุดข้อเสนอที่คัดสรรมาเพื่อเปิดใช้กรณีการใช้งานการโฆษณาโดยไม่ต้องมีการติดตามข้ามเว็บไซต์ การทดลองใช้ Origin เปิดโอกาสให้นักพัฒนาซอฟต์แวร์ประเมินและให้ความคิดเห็นเกี่ยวกับเทคโนโลยีเว็บใหม่ๆ ผ่านการทดสอบในชีวิตจริง ในการทดสอบต้นทางก่อนหน้านี้ เว็บไซต์สามารถทดสอบกับ API แต่ละรายการได้ สําหรับ Topics, FLEDGE และ Attribution Reporting API เรามีช่วงทดลองใช้จากต้นทางเดียวที่ช่วยให้เว็บไซต์ทําการทดสอบแบบรวมใน API ต่างๆ ซึ่งประกอบกันเป็นเวอร์ชันเริ่มต้นของวงจรโฆษณาจากต้นทางถึงปลายทาง API พร้อมให้ทดสอบใน Chrome 101 เบต้าขึ้นไป Chrome 101 เวอร์ชันเบต้ายังมีการอัปเดตการควบคุมของผู้ใช้ด้วย เนื่องจากเรายังคงปรับปรุงตัวเลือกการกำหนดค่าต่อไป

ในฐานะนักพัฒนาแอป คุณจะลงชื่อสมัครใช้ช่วงทดลองใช้จากต้นทางเดียวนี้ได้ ซึ่งจะช่วยให้คุณทดสอบ Topics, FLEDGE และ Attribution Reporting API ได้ คู่มือนี้จะอธิบายขั้นตอนการกำหนดค่าเพื่อเข้าถึง API, อธิบายวิธีตรวจสอบการกำหนดค่า และแสดงแหล่งข้อมูลเพิ่มเติมสำหรับการทดสอบ API

ช่วงทดลองใช้จากต้นทางมีอะไรบ้าง

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

  • Topics เพื่อสังเกตและเข้าถึงหัวข้อของเบราว์เซอร์ผ่าน document.browsingTopics()
  • FLEDGE เพื่อจัดการกลุ่มความสนใจของเบราว์เซอร์ รวมถึงการเสนอราคาและการเลือกโฆษณาตามกลุ่มเหล่านั้นและสัญญาณอื่นๆ
  • เฟรมที่มีรั้วล้อมเพื่อแสดงผล URL แบบทึบของผู้ชนะการประมูลโฆษณา FLEDGE
    • การรายงานการระบุแหล่งที่มาเพื่อวัดและรายงานประสิทธิภาพตลอดวงจรโฆษณา
    • ในการรายงานการระบุแหล่งที่มา รายงานที่รวบรวมได้ต้องได้รับการประมวลผลและรวบรวมโดยบริการรวบรวมข้อมูลเพื่อสร้างรายงานสรุป เราจะเผยแพร่เครื่องมือและคำแนะนำเพิ่มเติมสำหรับการทดสอบเวอร์ชันทดลองในพื้นที่และเวอร์ชันทดลองระดับต้นทางในเร็วๆ นี้
    • หากคุณเคยเข้าร่วมการทดลองใช้แหล่งที่มาก่อนหน้านี้สำหรับการรายงานการระบุแหล่งที่มา โปรดทราบว่าคุณจะต้องอัปเดตให้สอดคล้องกับการเปลี่ยนแปลง API ล่าสุด ดูรายละเอียดได้จากคำแนะนำในการย้ายข้อมูล

แม้ว่าการตั้งค่านี้จะทําให้การทดสอบแบบรวมใน API ทั้งหมดเหล่านี้เป็นไปได้ แต่คุณก็เลือกได้ว่าจะใช้แง่มุมใดบ้าง มากหรือน้อยเท่าใดก็ได้ตามต้องการ

นักพัฒนาแอปจะลงชื่อสมัครใช้ช่วงทดลองใช้จากต้นทางได้อย่างไร

ลงทะเบียนเข้าร่วมการทดลองใช้ความเกี่ยวข้องและการวัดผลของ Privacy Sandbox ให้ระบุโทเค็นช่วงทดลองใช้ในทุกหน้าที่ต้องการเรียกใช้โค้ด API โดยใช้แท็ก HTML ต่อไปนี้

  • แท็ก <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 และ Attribution Reporting มีคําแนะนําเฉพาะเกี่ยวกับการทดสอบของนักพัฒนาซอฟต์แวร์ในเครื่องสําหรับ API แต่ละรายการ API เหล่านี้จะไม่เปิดอยู่โดยค่าเริ่มต้น และต้องเปิดใช้ด้วย Flag เพื่อทดสอบ

หากต้องการเปิดใช้ API สำหรับการทดสอบ คุณต้องดำเนินการดังนี้

  • ใช้ Chrome 101 เบต้า ขึ้นไป
    • FLEDGE ต้องใช้ Chrome บนเดสก์ท็อป
    • API ไม่พร้อมใช้งานใน Chrome เวอร์ชัน iOS
  • เปิดใช้ API โดยใช้ Flag chrome://flags/#privacy-sandbox-ads-apis
    • Flag นี้จะเปิดใช้ API เพื่อให้ทดสอบได้ง่ายขึ้น หากคุณต้องการจำลองผู้ใช้เวอร์ชันทดลองใช้ต้นทางที่มีสิทธิ์ซึ่งการตั้งค่าเพิ่มเติมของผู้ใช้จะยังคงปิดใช้ API ได้ คุณควรเปิด Chrome โดยใช้ Flag ของ CLI ดังนี้ --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs * API แต่ละรายการอาจมี Flag เพิ่มเติมสําหรับการกําหนดค่าที่ละเอียดยิ่งขึ้น โปรดดูรายละเอียดในคู่มือแต่ละรายการ
    • การแจ้งว่าไม่เหมาะสมเพิ่มเติมอาจขัดแย้งกับรายการนี้ ดังนั้นให้พิจารณาตั้งค่าการแจ้งว่าไม่เหมาะสมรายการนี้รายการเดียวเท่านั้นหากพบปัญหา
  • เปิดใช้ช่วงทดลองใช้ 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 และนโยบายสิทธิ์สำหรับ "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และนโยบายสิทธิ์สําหรับ "run-ad-auction"

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

การรายงานการระบุแหล่งที่มา

ตรวจสอบออบเจ็กต์ attributionReporting ใน window และนโยบายสิทธิ์สำหรับ "attribution-reporting"

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

นักพัฒนาแอปจะแสดงความคิดเห็นและรับการสนับสนุนได้จากที่ใด

หน้าภาพรวมความคิดเห็นจะแสดงรายละเอียดเส้นทางต่างๆ สำหรับการเสนอความคิดเห็นเกี่ยวกับแง่มุมต่างๆ ของ Privacy Sandbox โดยมีส่วนเฉพาะสําหรับ Topics, FLEDGE และ การรายงานการระบุแหล่งที่มา ซึ่งจะให้ลิงก์แต่ละรายการสําหรับแต่ละ API

นอกจากนี้ เรายังอัปเดตความคืบหน้าในชุด Privacy Sandbox เป็นประจำ ซึ่งจะสรุปข่าวสำคัญ