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

หัวข้อ เฟรมที่มีรั้วล้อม และพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner

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

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

มิถุนายน 2023

การรวมข้อมูลส่วนตัวเพิ่มขึ้น 7% ในเวอร์ชันเสถียร

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

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

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

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

เมษายน 2023

การรวมข้อมูลส่วนตัวเพิ่มขึ้น 1% ในเวอร์ชันเสถียร

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

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

API การจัดสรรการเข้าชม สถานะ
การรายงานการระบุแหล่งที่มา แบบรวม - 5% 6% ของการเข้าชมแบบเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - ARA เท่านั้น
เฟรมที่มีการปิดกั้น แบบรวม - 5% 7% ของการเข้าชมแบบเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - พื้นที่เก็บข้อมูลที่ใช้ร่วมกัน (การเลือก URL) + เฟรมที่มีรั้วล้อมเท่านั้น
แยก - 1% - Protected Audience API + เฟรมที่มีการกำหนดเขตเท่านั้น
Protected Audience API แบบรวม - 5% 6% ของการเข้าชมแบบเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - Protected Audience API + เฟรมที่มีการกำหนดเขตเท่านั้น
การรวมข้อมูลส่วนตัว แบบรวม - 1% 1% ของการเข้าชมแบบเสถียรตั้งแต่วันที่ 17 เมษายน 2023
พื้นที่เก็บข้อมูลที่ใช้ร่วมกัน (การเลือก URL) แบบรวม - 5% 6% ของการเข้าชมแบบเสถียรตั้งแต่วันที่ 13 มีนาคม 2023
แยก - 1% - พื้นที่เก็บข้อมูลที่ใช้ร่วมกัน (การเลือก URL) + เฟรมที่มีรั้วล้อมเท่านั้น
หัวข้อ แบบรวม - 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 เวอร์ชันทดลองเดิมต่อไป ระบบจะสร้างการทดสอบใหม่สําหรับการรายงานการระบุแหล่งที่มา หัวข้อ การรวม Protected Audience API กับเฟรมที่มีการกำหนดขอบเขต และการรวมการดำเนินการเลือก URL ของพื้นที่เก็บข้อมูลที่ใช้ร่วมกันกับเฟรมที่มีการกำหนดขอบเขต ในการทดสอบแบบแยกแต่ละครั้ง ผู้ใช้ในกลุ่มนั้นจะมีเพียง API ที่กำหนดเท่านั้น

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

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

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

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

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

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

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

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

มกราคม 2023

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

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

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

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

พฤศจิกายน 2022

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

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

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

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

ปัจจุบันการรายงานการระบุแหล่งที่มา, Topics, Protected Audience API และเฟรมที่มีการกำหนดขอบเขตพร้อมใช้งานใน Chrome เวอร์ชันเสถียรทั้งหมด และจะเป็นส่วนหนึ่งของการเข้าชมที่เพิ่มขึ้น

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

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

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

ตุลาคม 2022

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

ไทม์ไลน์ของ Privacy Sandbox โดยรวมจะยังคงเหมือนเดิม

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

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

สิงหาคม 2022

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

พฤษภาคม 2022

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

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

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

เมษายน 2022

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

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

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

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

หากต้องการเปิดใช้งานการทดลองใช้จากต้นทางในเว็บไซต์ คุณจะต้องลงทะเบียนและฝังโทเค็นการทดลองใช้จากต้นทางที่ได้รับมอบหมาย (สตริงตามเวลาสำหรับการเข้าถึงการทดลองใช้จากต้นทางที่เฉพาะเจาะจง) ดูข้อมูลเพิ่มเติมได้ที่การเริ่มต้นใช้งานการทดลองใช้แหล่งที่มาของ 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);

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

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

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

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

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

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

ตรวจหาองค์ประกอบ

คุณควรตรวจสอบว่าฟีเจอร์ดังกล่าวรายงานว่าพร้อมใช้งานในเบราว์เซอร์ก่อนพยายามใช้งาน เช่นเดียวกับฟีเจอร์ทั้งหมดบนเว็บ ซึ่งทำได้โดยตรวจสอบว่ามี 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
}

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

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

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

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

  • ใช้เวอร์ชันและรุ่นที่เผยแพร่ของ Chrome ที่เปิดใช้ช่วงทดลองใช้จากต้นทาง

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

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

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

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

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

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

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

แนวทางที่แนะนำคือ

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

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

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

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

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

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

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

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

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

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

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

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

ดูหลักเกณฑ์เฉพาะเกี่ยวกับการทดสอบของนักพัฒนาแอปในพื้นที่ได้ที่

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

  • ใช้เวอร์ชันและรุ่นที่เผยแพร่ของ Chrome ที่มีฟีเจอร์ดังกล่าว
  • เปิดใช้ Ad Privacy API ทั้งหมดในส่วน chrome://settings/adPrivacy

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