ช่วงทดลองใช้จากต้นทางแบบรวมด้านความเกี่ยวข้องและการวัดผล

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

ตรวจสอบสถานะของการทดลองใช้ฟีเจอร์ต้นทาง

มิถุนายน 2023

การเพิ่มการใช้งาน Private Aggregation 7% ในเวอร์ชันเสถียร

Private Aggregation API จะพร้อมใช้งานในการเข้าชม Chrome Stable 7% ตั้งแต่วันอังคารที่ 6 มิถุนายน 2023 API จะพร้อมใช้งานในกลุ่มช่วงทดลองใช้จากต้นทางแบบรวมหลัก (5%), กลุ่มที่แยก Protected Audience (1%) และกลุ่มที่แยกพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน (1%) การจัดสรรการเข้าชมสำหรับ Protected Audience และ Shared Storage จะไม่เปลี่ยนแปลง เนื่องจากระบบจะเพิ่มการรวบรวมข้อมูลแบบส่วนตัวลงในการทดสอบที่แยกกันที่มีอยู่

การจัดสรรการเข้าชม ณ วันอังคารที่ 6 มิถุนายน

API การจัดสรรการเข้าชม สถานะ
การรายงานการระบุแหล่งที่มา แบบรวม - 5% 6% ของการเข้าชมที่เสถียร ณ วันที่ 13 มีนาคม 2023
แยก - 1% - ARA เท่านั้น
เฟรมที่มีการปิดกั้น แบบรวม - 5% 7% ของการเข้าชมที่เสถียร ณ วันที่ 13 มีนาคม 2023
แยก - 1% - เฉพาะพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน + การรวบรวมข้อมูลแบบส่วนตัว + เฟรมที่จำกัด
แยก - 1% - Protected Audience + การรวบรวมข้อมูลแบบส่วนตัว + Fenced Frame เท่านั้น
Protected Audience แบบรวม - 5% 6% ของการเข้าชมที่เสถียร ณ วันที่ 13 มีนาคม 2023
แยก - 1% - Protected Audience + การรวบรวมข้อมูลแบบส่วนตัว + Fenced Frame เท่านั้น
การรวมข้อมูลแบบส่วนตัว แบบรวม - 5% การเข้าชมในเวอร์ชันเสถียร 7% ณ วันที่ 6 มิถุนายน 2023
แยก - 1% - Protected Audience + การรวบรวมข้อมูลแบบส่วนตัว + Fenced Frame เท่านั้น
แยก - 1% - เฉพาะพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน + การรวบรวมข้อมูลแบบส่วนตัว + เฟรมที่จำกัด
Shared Storage แบบรวม - 5% 6% ของการเข้าชมที่เสถียร ณ วันที่ 13 มีนาคม 2023
แยก - 1% - เฉพาะพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน + การรวบรวมข้อมูลแบบส่วนตัว + เฟรมที่จำกัด
หัวข้อ แบบรวม - 5% 6% ของการเข้าชมที่เสถียร ณ วันที่ 13 มีนาคม 2023
แยก - 1% - หัวข้อเท่านั้น

ข้อมูลอัปเดตก่อนหน้า

ดูข้อมูลอัปเดตก่อนหน้านี้เกี่ยวกับการทดลองใช้ Origin

เมษายน 2023

การเพิ่มการใช้งาน Private Aggregation 1% ในเวอร์ชันเสถียร

ช่วงทดลองใช้จากต้นทางของ Private Aggregation API จะพร้อมใช้งานในการเข้าชมการทดสอบแบบรวมของ Chrome Stable 1% ตั้งแต่วันจันทร์ที่ 17 เมษายน ฟังก์ชัน sendHistogramReport() ของ Private Aggregation พร้อมให้ใช้งานใน Worklet ของ Protected Audience API และ Shared Storage

การจัดสรรการเข้าชมจะมีลักษณะดังต่อไปนี้ตั้งแต่วันจันทร์ที่ 17 เมษายน

API การจัดสรรการเข้าชม สถานะ
การรายงานการระบุแหล่งที่มา แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - ARA เท่านั้น
เฟรมที่มีการปิดกั้น แบบรวม - 5% 7% ของการเข้าชมที่เสถียรตั้งแต่วันที่ 13 มีนาคม 2023
Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
แยก - 1% - Protected Audience API + Fenced Frame เท่านั้น
Protected Audience API แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - Protected Audience API + Fenced Frame เท่านั้น
การรวมข้อมูลแบบส่วนตัว รวม - 1% 1% ของการเข้าชมที่เสถียรตั้งแต่วันที่ 17 เมษายน 2023
Shared Storage (การเลือก URL) แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
หัวข้อ แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - หัวข้อเท่านั้น

มีนาคม 2023

การอัปเดตไทม์ไลน์

ก่อนหน้านี้เราได้แจ้งให้ทราบว่าเราจะเริ่มการทดสอบแบบแยกกันในวันจันทร์ที่ 13 มีนาคม 2023 แต่ตอนนี้การทดสอบใหม่จะเริ่มในวันพฤหัสบดีที่ 16 มีนาคม 2023 เนื่องจากต้องใช้เวลาเพิ่มเติมในการตั้งค่าการทดสอบ การเพิ่ม Protected Audience API อีก 1% จาก 4% เป็น 5% จะเกิดขึ้นในวันพฤหัสบดีที่ 16 มีนาคม 2023

การเพิ่มการใช้งาน Protected Audience API กลับเป็น 1%

เมื่อเดือนที่แล้ว เราได้ลดการเข้าชมช่วงทดลองใช้ Protected Audience API จากต้นทางชั่วคราวจาก 5% เป็น 4% ของ Chrome เวอร์ชันเสถียรเพื่อทำการทดสอบ การทดสอบเบื้องต้นเสร็จสิ้นแล้ว และเรามีแผนที่จะเพิ่ม Protected Audience API กลับไปเป็น 5% จาก 4% สำหรับการทดสอบแบบรวมในวันพฤหัสบดีที่ 16 มีนาคม 2023

ผู้ใช้ที่เพิ่มขึ้นจะเป็นกลุ่มผู้ใช้ชุดเดียวกับที่ลดลง อย่างไรก็ตาม กลุ่มความสนใจก่อนหน้านี้ได้หมดอายุแล้ว เนื่องจากผ่านไปนานกว่า 30 วันนับตั้งแต่การลดการใช้งาน

การทดสอบที่แยกกัน

เราจะสร้างการทดสอบที่แยกต่างหากสำหรับแต่ละ API นอกเหนือจากการทดสอบแบบรวมที่มีอยู่ เพื่อปรับปรุงกระบวนการทดสอบและสังเกตเมตริกของ API ในช่วงทดลองใช้แหล่งที่มาต่อไป ระบบจะสร้างการทดสอบใหม่สำหรับ Attribution Reporting, Topics, การรวม Protected Audience API และ Fenced Frame รวมถึงการรวมการดำเนินการเลือก URL ของ Shared Storage และ Fenced Frame ในการทดสอบที่แยกกันแต่ละครั้ง จะมีเฉพาะ API ที่กำหนดไว้เท่านั้นที่ผู้ใช้ในกลุ่มนั้นจะใช้ได้

API การจัดสรรการเข้าชม
การทดสอบที่แยกกัน
การรายงานการระบุแหล่งที่มา 1%
Protected Audience API + Fenced Frame 1%
Shared Storage (การเลือก URL) + Fenced Frame 1%
หัวข้อ 1%

ตั้งแต่วันพฤหัสบดีที่ 16 มีนาคมเป็นต้นไป คุณจะเริ่มได้รับการเข้าชม Chrome Stable เพิ่มอีก 1% สำหรับ API ที่ระบุไว้ข้างต้น นอกเหนือจากการเข้าชม 5% ที่คุณได้รับจากการทดสอบแบบรวมที่มีอยู่ ระบบจะจัดสรรผู้ใช้ใหม่ ให้กับการทดสอบแต่ละรายการ

การจัดสรรการเข้าชม

การจัดสรรการเข้าชมการทดสอบต้นทางแบบรวมในปัจจุบัน ณ วันอังคารที่ 28 กุมภาพันธ์ มีดังนี้

API การจัดสรรการเข้าชมของการทดสอบแบบรวมในปัจจุบัน
การรายงานการระบุแหล่งที่มา 5%
เฟรมที่มีการปิดกั้น 5%
Protected Audience API 4%
Shared Storage (การเลือก URL) 5%
หัวข้อ 5%

การจัดสรรการเข้าชมจะมีลักษณะดังต่อไปนี้โดยเริ่มตั้งแต่วันพฤหัสบดีที่ 16 มีนาคม หลังจากที่ Protected Audience API กลับมาเพิ่มขึ้นอีกครั้ง และการทดสอบแบบแยกใหม่เริ่มขึ้น

API การจัดสรรการเข้าชมใหม่ สถานะ
การรายงานการระบุแหล่งที่มา แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 16 มีนาคม 2023
แยก - 1% - ARA เท่านั้น
เฟรมที่มีการปิดกั้น แบบรวม - 5% 7% ของการเข้าชมที่เสถียรตั้งแต่วันที่ 16 มีนาคม 2023
Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
แยก - 1% - Protected Audience API + Fenced Frame เท่านั้น
Protected Audience API รวม - 5% (การจัดสรรปัจจุบัน 4% + เพิ่มขึ้นอีก 1%) 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 16 มีนาคม 2023
แยก - 1% - Protected Audience API + Fenced Frame เท่านั้น
Shared Storage
(การเลือก URL) 		แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 16 มีนาคม 2023
Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
หัวข้อ แบบรวม - 5% 6% ของการเข้าชมเวอร์ชันเสถียรตั้งแต่วันที่ 16 มีนาคม 2023
แยก - 1% - หัวข้อเท่านั้น

การเปลี่ยนแปลงเหล่านี้จะไม่ส่งผลต่อการตั้งค่าโทเค็นทดลองใช้ต้นทางที่มีอยู่ และคุณไม่จำเป็นต้องต่ออายุหรือสร้างโทเค็นทดลองใช้ต้นทางใหม่

มกราคม 2023

ในฐานะที่เป็นส่วนหนึ่งของการตรวจสอบการถดถอยของ Chrome เราจะลดการเข้าชมช่วงทดลองใช้ Protected Audience API จากต้นทางจาก 5% เป็น 4% ของ Chrome Stable ชั่วคราวตั้งแต่วันที่ 26 มกราคม 2023 เราคาดว่าการตรวจสอบจะใช้เวลาประมาณ 1 เดือน และจะแจ้งให้คุณทราบเมื่อมีการเพิ่มการเข้าชมอีกครั้ง

การเปลี่ยนแปลงนี้จะเกิดขึ้นโดยอัตโนมัติ และจะไม่ส่งผลต่อโทเค็นทดลองใช้ต้นทางที่มีอยู่ สำหรับผู้ใช้ในการเข้าชม 1% ที่จะลดลง กลุ่มความสนใจจะยังคงอยู่ในเบราว์เซอร์ของผู้ใช้ ผู้ใช้กลุ่มเดิมจะอยู่ในช่วงการกลับมาเพิ่มขึ้น และสามารถนำกลุ่มความสนใจของผู้ใช้เหล่านั้นกลับมาใช้ซ้ำได้ อย่างไรก็ตาม กลุ่มความสนใจจะหมดอายุใน 30 วัน และการตรวจสอบการถดถอยอาจใช้เวลานานกว่านั้น

นอกจากนี้ ช่วงทดลองใช้ URL Selection API จากต้นทางของพื้นที่เก็บข้อมูลที่ใช้ร่วมกันจะเพิ่มขึ้นเป็น 5% ของการเข้าชม Chrome เวอร์ชันเสถียรตั้งแต่วันที่ 26 มกราคม 2023

API หมายเหตุ
Attribution Reporting พร้อมให้บริการในเวอร์ชันเสถียร โดยเพิ่มเป็น 5% ตั้งแต่วันที่ 26 ตุลาคม 2022
หัวข้อ พร้อมให้บริการในเวอร์ชันเสถียร โดยเพิ่มเป็น 5% ตั้งแต่วันที่ 26 ตุลาคม 2022
Protected Audience API มีให้บริการในเวอร์ชันเสถียร โดยจะลดลงชั่วคราวเหลือ 4% ตั้งแต่วันที่ 26 มกราคม 2023
เฟรมที่มีการปิดกั้น พร้อมให้บริการในเวอร์ชันเสถียร โดยจะเพิ่มเป็น 5% ตั้งแต่วันที่ 9 พฤศจิกายน 2022
Shared Storage พร้อมใช้งานในเวอร์ชันเสถียร โดยจะเพิ่มขึ้น 5% ตั้งแต่วันที่ 26 มกราคม 2023

พฤศจิกายน 2022

API `selectURL` ของพื้นที่เก็บข้อมูลที่ใช้ร่วมกันจะเข้าร่วมช่วงทดลองใช้จากต้นทางที่การเข้าชม Chrome เวอร์ชันเสถียร 1% ตั้งแต่วันที่ 9 พฤศจิกายน

ตามที่ได้ประกาศไปก่อนหน้านี้ในบล็อกโพสต์การเพิ่มการทดลองใช้จากต้นทางของ Privacy Sandbox เพื่อความเกี่ยวข้องและการวัดผลเป็น 5% ตอนนี้ Attribution Reporting และ Topics อยู่ที่ 5% แล้ว โดย Protected Audience API และ Fenced Frame จะตามมาในวันที่ 9 พฤศจิกายน

API หมายเหตุ
Attribution Reporting พร้อมใช้งานในเวอร์ชันเสถียร โดยเพิ่มเป็น 5% ตั้งแต่วันที่ 26 ตุลาคม
หัวข้อ พร้อมใช้งานในเวอร์ชันเสถียร โดยเพิ่มเป็น 5% ตั้งแต่วันที่ 26 ตุลาคม
Protected Audience API พร้อมใช้งานในเวอร์ชันเสถียร โดยจะเพิ่มเป็น 5% ตั้งแต่วันที่ 9 พฤศจิกายน
เฟรมที่มีการปิดกั้น พร้อมใช้งานในเวอร์ชันเสถียร โดยจะเพิ่มเป็น 5% ตั้งแต่วันที่ 9 พฤศจิกายน
Shared Storage จะพร้อมให้บริการในเวอร์ชันเสถียร โดยเริ่มที่ 1% ตั้งแต่วันที่ 9 พฤศจิกายน

ตุลาคม 2022: เพิ่มขึ้น 5%

ขณะนี้ Attribution Reporting, Topics, Protected Audience API และ Fenced Frame พร้อมให้บริการใน Chrome Stable และจะเป็นส่วนหนึ่งของการเข้าชมที่เพิ่มขึ้น

เราจะเริ่มเพิ่มการเข้าชมสำหรับการรายงานการระบุแหล่งที่มาและ Topics ตั้งแต่สัปดาห์นี้ ส่วน Protected Audience API และ Fenced Frame จะเพิ่มขึ้นตั้งแต่วันที่ 9 พฤศจิกายน

อ่านเพิ่มเติมในบล็อกโพสต์เพิ่มความเกี่ยวข้องและการวัดผลของ Privacy Sandbox ในช่วงทดลองใช้เดิมเป็น 5%

API หมายเหตุ
Attribution Reporting โดยจะพร้อมให้บริการในเวอร์ชันเสถียร และจะเพิ่มเป็น 5% หลังวันที่ 26 ตุลาคม
หัวข้อ โดยจะพร้อมให้บริการในเวอร์ชันเสถียร และจะเพิ่มเป็น 5% หลังวันที่ 26 ตุลาคม
Protected Audience API พร้อมใช้งานในเวอร์ชันเสถียร โดยจะเพิ่มเป็น 5% ตั้งแต่วันที่ 9 พฤศจิกายน
เฟรมที่มีการปิดกั้น พร้อมใช้งานในเวอร์ชันเสถียร โดยจะเพิ่มเป็น 5% ตั้งแต่วันที่ 9 พฤศจิกายน
Shared Storage ขณะนี้ฟีเจอร์นี้พร้อมใช้งานใน Canary, Dev และเบต้า M105 ขึ้นไปเท่านั้น

ตุลาคม 2022

การขยายเวลานี้มีขึ้นเพื่อให้ระบบนิเวศมีเวลาในช่อง Stable ในการ ทดสอบและตรวจสอบการปรับปรุง API ต่อไป พร้อมทั้งแสดงความคิดเห็น ตามไทม์ไลน์สาธารณะที่มีอยู่

ไทม์ไลน์โดยรวมของ Privacy Sandbox จะไม่มีการเปลี่ยนแปลง

API ที่รวมอยู่ในการทดลองใช้

API หมายเหตุ
Attribution Reporting คู่มือนักพัฒนาซอฟต์แวร์ สำหรับการทดลองใช้จากต้นทาง
Protected Audience API คู่มือนักพัฒนาซอฟต์แวร์ สำหรับการทดลองใช้จากต้นทาง
หัวข้อ คู่มือนักพัฒนาซอฟต์แวร์ สำหรับการทดลองใช้จากต้นทาง
เฟรมที่มีการ ปิดกั้น ดูคำแนะนำเกี่ยวกับ Protected Audience API สำหรับการใช้งานช่วงทดลองใช้จากต้นทาง
Shared Storage ขณะนี้ฟีเจอร์นี้พร้อมใช้งานใน Canary, Dev และเบต้า M105 ขึ้นไปเท่านั้น

สิงหาคม 2022

  • ความพร้อมใช้งานของ Origin Trial จะเพิ่มขึ้นเป็น 1% ของผู้ใช้เดสก์ท็อปจาก Chrome เวอร์ชันเสถียร 104
  • เราจะแจ้งให้ทราบเมื่อฟีเจอร์นี้พร้อมให้บริการแก่ผู้ใช้บนอุปกรณ์เคลื่อนที่
  • เวอร์ชันก่อนเสถียร (Canary, เบต้า) จะยังคงมีผู้ใช้ 50%
  • API ไม่พร้อมใช้งานใน Chrome สำหรับ iOS

พฤษภาคม 2022

ความพร้อมใช้งานของช่วงทดลองใช้จากต้นทางจะเพิ่มขึ้นเป็น50% ของผู้ใช้จาก Chrome 102 เบต้า

API ที่รวมอยู่ในการทดลองใช้

API หมายเหตุ
Attribution Reporting คู่มือนักพัฒนาซอฟต์แวร์ สำหรับการทดลองใช้จากต้นทาง
Protected Audience API คู่มือนักพัฒนาซอฟต์แวร์ สำหรับการทดลองใช้จากต้นทาง
หัวข้อ คู่มือนักพัฒนาซอฟต์แวร์สำหรับ Origin Trial เราได้ปิดใช้ Topics ในช่วงทดลองใช้แหล่งที่มาเป็นระยะเวลาสั้นๆ เนื่องจากข้อบกพร่องที่ ส่งผลต่อความเสถียรของเบราว์เซอร์
เฟรมที่มีการ ปิดกั้น เพิ่ม Fenced Frame ลงในการทดลองใช้แหล่งที่มา ดูคําแนะนําเกี่ยวกับ Protected Audience API สําหรับการใช้งานการทดสอบ

เมษายน 2022

ช่วงทดลองใช้แหล่งที่มาจะเริ่มต้นด้วยผู้ใช้จำนวนจำกัดจาก Chrome 102 เบต้า

API ที่รวมอยู่ในการทดลองใช้

API หมายเหตุ
Attribution Reporting โพสต์ความตั้งใจ ในการทดลอง (I2E) ของแต่ละบุคคล Attribution Reporting ยังพร้อมให้บริการในรูปแบบ การทดสอบต้นทางแบบรายบุคคลด้วย
Protected Audience API โพสต์ความตั้งใจ ในการทดลอง (I2E) ของแต่ละบุคคล Protected Audience API พร้อมใช้งานในเดสก์ท็อปเท่านั้นโดยมีฟังก์ชันการทำงานบางส่วน
หัวข้อ โพสต์ความตั้งใจ ในการทดลอง (I2E) ของแต่ละบุคคล

ลงชื่อสมัครใช้และกำหนดค่าการทดลองใช้จากต้นทาง

หากต้องการเปิดใช้งานการทดลองใช้จากต้นทางในเว็บไซต์ คุณจะต้องลงทะเบียนและฝัง โทเค็นการทดลองใช้จากต้นทางที่กำหนด (สตริงตามเวลาสำหรับการเข้าถึงการทดลองใช้จากต้นทางที่เฉพาะเจาะจงของคุณ) ดูข้อมูลเพิ่มเติมได้ในการเริ่มต้นใช้งาน Origin Trials ของ Chrome

ระบบจะให้โทเค็นช่วงทดลองใช้จากต้นทางทันที และคุณสามารถเพิกถอนหรือสร้างโทเค็นใหม่ได้ทุกเมื่อ

สำหรับทุกหน้าเว็บที่คุณต้องการใช้ช่วงทดลองใช้แหล่งที่มา คุณจะต้องใส่โทเค็นช่วงทดลองใช้ใน HTML หรือการตอบกลับของหน้าเว็บนั้นๆ

ใช้แท็ก <meta> ในส่วน <head> ของหน้าเว็บ

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

หรือจะใส่ส่วนหัว HTTP ต่อไปนี้ในการตอบกลับของหน้าเว็บก็ได้

Origin-Trial: TOKEN_GOES_HERE

กำหนดค่าด้วย iframe

หากคุณใช้ฟีเจอร์ช่วงทดลองใช้จากต้นทางภายใน iframe (เช่น joinAdInterestGroup() ของ Protected Audience API) คุณจะต้องระบุโทเค็นภายใน iframe และต้องตรงกับต้นทางของ iframe

กำหนดค่าข้ามเว็บไซต์ด้วย JavaScript

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

  • เลือกตัวเลือกการจับคู่กับบุคคลที่สามเมื่อลงทะเบียนเพื่อทดลองใช้ต้นทาง
  • ฟิลด์ต้นทางของเว็บควรเป็นต้นทางของสคริปต์
  • แทรกแท็ก <meta> ลงในหน้าเว็บระดับบนสุด (นั่นคือหน้าเว็บของบุคคลที่หนึ่ง ไม่ใช่เนื้อหาของคุณเอง) จากสคริปต์ เช่น
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

แก้ไขข้อบกพร่องของช่วงทดลองใช้จากต้นทาง

คุณสามารถตรวจสอบสถานะของการทดลองใช้ต้นทางได้ในแผง DevTools > Applications

สถานะโทเค็นสำเร็จและเปิดใช้แล้ว
สถานะโทเค็นสำเร็จและเปิดใช้
  1. เลื่อนลงไปที่แผงเฟรม
  2. เลือกเฟรมที่คาดว่าจะตั้งค่าโทเค็น เช่น เฟรมบนสุด สำหรับหน้าเว็บระดับบนสุด หรือ iframe ที่เฉพาะเจาะจงสำหรับหน้าเว็บที่ฝัง
  3. ในแผงด้านขวา ให้เลื่อนลงไปที่ส่วนทดลองใช้ฟีเจอร์ต้นทาง
  4. คุณควรเห็นรายการสำหรับการทดลองใช้ PrivacySandboxAdsAPIs
  5. ขยายรายการนี้เพื่อดูสถานะของการทดลองใช้ Origin และโทเค็นเฉพาะของคุณ

การทดลองใช้ต้นทางจำกัดไว้สำหรับผู้ใช้ Chrome เพียงบางส่วน และเบราว์เซอร์ของคุณอาจไม่ได้อยู่ในกลุ่มการทดสอบ ด้วยเหตุนี้ คุณจึงอาจเห็นTrialNotAllowed ข้อความสีแดงที่PrivacySandboxAdsAPIs เมื่อขยายรายการเพื่อตรวจสอบ สถานะโทเค็น หากแสดงข้อความSuccessสีเขียว แสดงว่าการกำหนดค่า Origin Trial ถูกต้อง ผู้ใช้ที่มีสิทธิ์จะเห็นข้อความที่ตั้งค่าเป็น Enabled

สถานะโทเค็นสำเร็จและไม่ได้เปิดใช้
สถานะโทเค็นสำเร็จและไม่ได้เปิดใช้

หากเห็นข้อความอื่น โปรดดูการแก้ปัญหา Origin Trials ของ Chrome เพื่อดู รายการตรวจสอบแบบละเอียดเพื่อตรวจสอบการกำหนดค่า Origin Trial

ตรวจหาฟีเจอร์

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

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

if ('runAdAuction' in navigator) {
  // Protected Audience API enabled
}

if ('browsingTopics' in document) {
  // Topics enabled
}

if ('HTMLFencedFrameElement' in window) {
  // Fenced Frames enabled
}

if ('sharedStorage' in window) {
  // Shared Storage enabled
}

if (window?.sharedStorage?.selectURL instanceof Function) {
  // optionally check specifically for the selectURL function in Shared Storage
}

พิจารณาการมีสิทธิ์ของผู้ใช้

การทดลองใช้ Origin กำลังทำงานสำหรับผู้ใช้ Chrome เพียงบางส่วน นอกจากนี้ ผู้ใช้ยังต้องเปิดใช้ฟังก์ชันที่เกี่ยวข้องในการตั้งค่าของตนจึงจะมีสิทธิ์ใช้ช่วงทดลอง ใช้ด้วย โดยมีข้อกำหนดดังนี้

การตั้งค่าเบราว์เซอร์

ผู้ใช้ต้องมีคุณสมบัติดังนี้จึงจะมีสิทธิ์ทดลองใช้

  • ใช้ Chrome เวอร์ชันและแชแนลที่ช่วงทดลองใช้จากต้นทางกำลังทำงานอยู่

  • อยู่ในกลุ่มทดสอบที่ใช้งานอยู่ใน Chrome

การตั้งค่าของผู้ใช้

ผู้ใช้ต้องมีคุณสมบัติดังนี้จึงจะมีสิทธิ์ทดลองใช้

  • เปิดใช้ช่วงทดลองใช้ Privacy Sandbox ผ่านการตั้งค่า > ความปลอดภัยและความเป็นส่วนตัว > Privacy Sandbox ซึ่งเข้าถึงได้ผ่าน chrome://settings/adPrivacy
  • เปิดใช้คุกกี้ของบุคคลที่สามผ่านการตั้งค่า > ความปลอดภัยและความเป็นส่วนตัว > คุกกี้และข้อมูลเว็บไซต์อื่นๆ ที่ตั้งค่าเป็น "อนุญาตคุกกี้ทั้งหมด" หรือ "บล็อก คุกกี้ของบุคคลที่สามในโหมดไม่ระบุตัวตน" ซึ่งเข้าถึงได้ผ่าน chrome://settings/cookies
  • อยู่ในเซสชันการท่องเว็บมาตรฐานและไม่ได้อยู่ในโหมดไม่ระบุตัวตน

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

ควบคุมการเข้าร่วมการทดลองใช้จากต้นทาง

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

แนวทางที่ดีในที่นี้คือ

  1. รวมโทเค็นการทดสอบต้นทางโดยค่าเริ่มต้นในบริบททั้งหมดที่คุณต้องการ ทดสอบ
  2. ใช้การตรวจหาฟีเจอร์เพื่อตรวจสอบ API ที่ใช้งานอยู่
  3. หาก API ทำงานอยู่ (และเบราว์เซอร์มีสิทธิ์เข้าร่วมการทดสอบนี้) ให้เลือกว่าจะใช้ API หรือไม่โดยอิงตามเกณฑ์การทดสอบของคุณเอง เช่น หากคุณมีโครงสร้างพื้นฐานการทดสอบ A/B อยู่แล้วเพื่อ ทดสอบเปอร์เซ็นต์ของการเข้าชม การสุ่มตัวอย่าง หรือแอตทริบิวต์อื่นๆ ตอนนี้คุณสามารถตัดสินใจได้ว่าจะใช้ฟีเจอร์ใดอย่างจริงจัง

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

การควบคุมช่วงทดลองใช้จากต้นทางตามภูมิภาค

คุณเลือกไม่ใช้ช่วงทดลองใช้จากต้นทางสำหรับบางภูมิภาคไม่ได้ Origin Trial จะทำงานในหน้าเว็บที่มีโทเค็น ซึ่งรวมไว้ผ่านส่วนหัว HTTP (ฝั่งเซิร์ฟเวอร์) หรือเมตาแท็ก HTML (ฝั่งไคลเอ็นต์)

หากระบุตำแหน่งของผู้ใช้ได้ คุณก็เขียนโค้ดเพื่อรวม โทเค็นทดลองใช้แหล่งที่มาตามข้อมูลตำแหน่งนั้นได้ เช่น คุณ อาจพยายามใช้ที่อยู่ IP เพื่อระบุตำแหน่งของผู้ใช้ เนื่องจากสามารถปลอมแปลงที่อยู่ IP ได้ วิธีนี้จึงไม่ใช่วิธีแก้ปัญหาที่รับประกันได้

อย่างไรก็ตาม ต้นทางที่เฉพาะเจาะจงทางภูมิศาสตร์สามารถตั้งค่านโยบาย สิทธิ์เพื่อควบคุมฟีเจอร์ที่ ใช้ได้ เช่น us.example.com และ uk.example.com เป็นต้น ต้นทางที่เฉพาะเจาะจงตามภูมิศาสตร์ซึ่งควบคุมได้ ซึ่งไม่ได้หมายความว่า ภูมิภาคได้เลือกไม่เข้าร่วมช่วงทดลองใช้จากต้นทาง

นโยบายสิทธิ์ช่วยให้เว็บไซต์เพิ่มข้อมูลโค้ดเล็กๆ ลงในหน้าเว็บ ซึ่งจะให้คำสั่งแก่เบราว์เซอร์ เมื่อหน้าเว็บโหลด เบราว์เซอร์จะ อ่านวิธีการของนโยบายสิทธิ์ และจะอนุญาตหรือบล็อกฟีเจอร์ (หรือ API) ตามที่ระบุไว้ในนโยบายสิทธิ์ หากเว็บไซต์ต้องการจำกัด API ในภูมิภาคที่เฉพาะเจาะจง นักพัฒนาซอฟต์แวร์สามารถตั้งค่านโยบายสำหรับทุกหน้าที่ขอ จากภูมิภาคนั้นได้

ต่ออายุโทเค็น

โทเค็นช่วงทดลองใช้จากต้นทางจะหมดอายุใน 6 สัปดาห์นับจากวันที่ออก (หรือเมื่อสิ้นสุดช่วงทดลองใช้หากถึงก่อน)

คุณต้องต่ออายุและติดตั้งใช้งานโทเค็นใหม่ภายในกรอบเวลานั้นเพื่อให้ใช้ฟีเจอร์ทดลองใช้จากต้นทางได้อย่างต่อเนื่อง

การต่ออายุโทเค็นใช้เวลาเพียงไม่กี่นาที และคุณสามารถติดตั้งใช้งานโทเค็นหลายรายการสำหรับการทดลองใช้เดียวกันภายในหน้าเดียวกันได้ คุณสามารถติดตั้งใช้งานโทเค็นที่ต่ออายุแล้วก่อนที่โทเค็นที่มีอยู่จะหมดอายุ เพื่อให้ผู้ใช้สามารถใช้บริการได้อย่างต่อเนื่อง

ทดสอบในเครื่อง

ดูคำแนะนำที่เฉพาะเจาะจงเกี่ยวกับการทดสอบของนักพัฒนาแอปในพื้นที่ได้ที่

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

  • ใช้เวอร์ชันและช่องของ Chrome ที่มีฟีเจอร์พร้อมใช้งาน
  • เปิดใช้ API ความเป็นส่วนตัวเกี่ยวกับโฆษณาทั้งหมดในส่วน chrome://settings/adPrivacy

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