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

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

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

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

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

  • หัวข้อเพื่อสังเกตและเข้าถึง หัวข้อของเบราว์เซอร์ผ่าน document.browsingTopics()
  • 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

นักพัฒนาแอปทดสอบในเครื่องอย่างไร

เอกสารสำหรับนักพัฒนาแอปแต่ละรายสำหรับ หัวข้อ FLEDGE และการระบุแหล่งที่มา การรายงานจะระบุข้อมูลต่อไปนี้ คำแนะนำที่เจาะจงเกี่ยวกับการทดสอบนักพัฒนาซอฟต์แวร์ในพื้นที่สำหรับ API แต่ละรายการ API ไม่ได้เปิดอยู่ ตามค่าเริ่มต้น และต้องเปิดใช้ด้วย แฟล็กสำหรับ การทดสอบ

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

  • ใช้ Chrome 101 เบต้า ขึ้นไป
    • FLEDGE ต้องใช้ Chrome บนเดสก์ท็อป
    • API ไม่มีให้บริการใน Chrome เวอร์ชัน iOS
  • เปิดใช้ API โดยใช้ chrome://flags/#privacy-sandbox-ads-apis แจ้ง
    • แฟล็กนี้จะบังคับให้ API เปิดอยู่เพื่อให้ทดสอบได้ง่ายขึ้น จำลองผู้ใช้ช่วงทดลองใช้จากต้นทางที่มีสิทธิ์ การตั้งค่ายังสามารถปิดใช้ API ได้ ดังนั้นคุณควรเปิด Chrome โดยใช้แฟล็ก 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 และ นโยบายสิทธิ์](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) สำหรับ "หัวข้อการเรียกดู"

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 ในแง่มุมต่างๆ มีส่วนที่เฉพาะเจาะจงสำหรับ หัวข้อ FLEDGE และการระบุแหล่งที่มา การรายงานที่ให้ ลิงก์แต่ละรายการสำหรับ API แต่ละรายการ

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