Hộp cát về quyền riêng tư bao gồm một số đề xuất để cho phép các trường hợp sử dụng quảng cáo mà không cần theo dõi trên nhiều trang web. Thử nghiệm nguồn gốc tạo cơ hội cho nhà phát triển đánh giá và đưa ra ý kiến phản hồi về các công nghệ web mới thông qua thử nghiệm trong thế giới thực. Bản dùng thử theo nguyên gốc Mức độ liên quan và hoạt động đo lường của Hộp cát về quyền riêng tư cung cấp một bản dùng thử duy nhất cho phép các trang web chạy các thử nghiệm hợp nhất trên Attribution Reporting API, Protected Audience API, Topics API, API Khung bảo vệ và API Bộ nhớ dùng chung. Nhà phát triển có thể đăng ký bản dùng thử theo nguyên gốc duy nhất này để cho phép bạn kiểm thử trên Topics API, Protected Audience API và Attribution Reporting API. Hướng dẫn này sẽ hướng dẫn bạn các bước định cấu hình để truy cập vào API, cho bạn biết cách xác thực cấu hình và cung cấp thêm tài nguyên để kiểm thử dựa trên API.
Kiểm tra trạng thái của thử nghiệm nguồn
Tháng 6 năm 2023
Tăng dần tỷ lệ sử dụng tính năng Tổng hợp riêng tư lên 7% trong phiên bản Ổn định
Private Aggregation API sẽ có sẵn cho 7% lưu lượng truy cập Chrome Stable kể từ thứ Ba, ngày 6 tháng 6 năm 2023. API này sẽ có trong nhóm dùng thử theo nguyên gốc hợp nhất chính (5%), nhóm Protected Audience riêng biệt (1%) và nhóm Shared Storage riêng biệt (1%). Việc phân bổ lưu lượng truy cập cho Protected Audience và Shared Storage sẽ không thay đổi vì Private Aggregation đang được thêm vào các thử nghiệm riêng biệt hiện có.
Phân bổ lưu lượng truy cập kể từ Thứ Ba, ngày 6 tháng 6:
API | Phân bổ lưu lượng truy cập | Trạng thái |
Attribution Reporting | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định tính đến ngày 13 tháng 3 năm 2023 |
Isolated – 1% – Chỉ ARA | ||
Khung bảo vệ | Hợp nhất – 5% | 7% lưu lượng truy cập của phiên bản ổn định tính đến ngày 13 tháng 3 năm 2023 |
Riêng biệt – 1% – Chỉ Bộ nhớ dùng chung + Tổng hợp riêng tư + Khung bảo vệ | ||
Riêng biệt – 1% – Chỉ Protected Audience + Private Aggregation + Fenced Frames | ||
Protected Audience | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định tính đến ngày 13 tháng 3 năm 2023 |
Riêng biệt – 1% – Chỉ Protected Audience + Private Aggregation + Fenced Frames | ||
Tổng hợp riêng tư | Hợp nhất – 5% | 7% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 6 tháng 6 năm 2023 |
Riêng biệt – 1% – Chỉ Protected Audience + Private Aggregation + Fenced Frames | ||
Riêng biệt – 1% – Chỉ Bộ nhớ dùng chung + Tổng hợp riêng tư + Khung bảo vệ | ||
Bộ nhớ dùng chung | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định tính đến ngày 13 tháng 3 năm 2023 |
Riêng biệt – 1% – Chỉ Bộ nhớ dùng chung + Tổng hợp riêng tư + Khung bảo vệ | ||
Chủ đề | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định tính đến ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% – Chỉ chủ đề |
Thông tin cập nhật trước đây
Xem các thông tin cập nhật trước đây về thử nghiệm nguồn gốc.
Tháng 4 năm 2023
Tăng dần tỷ lệ sử dụng tính năng Tổng hợp riêng tư lên 1% trong phiên bản Ổn định
Bản dùng thử theo nguyên gốc Private Aggregation API sẽ có sẵn ở 1% lưu lượng truy cập thử nghiệm hợp nhất của Chrome Stable kể từ thứ Hai, ngày 17 tháng 4. Bạn có thể sử dụng hàm sendHistogramReport()
của Private Aggregation trong Protected Audience API và các worklet Shared Storage.
Việc phân bổ lưu lượng truy cập sẽ diễn ra như sau kể từ thứ Hai, ngày 17 tháng 4:
API | Phân bổ lưu lượng truy cập | Trạng thái |
Attribution Reporting | Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 13 tháng 3 năm 2023 |
Isolated – 1% – Chỉ ARA | ||
Khung bảo vệ | Hợp nhất – 5% | 7% lưu lượng truy cập ổn định kể từ ngày 13 tháng 3 năm 2023 |
Isolated – 1% – Shared Storage (URL Selection) + Fenced Frames only | ||
Riêng biệt – 1% – Chỉ Protected Audience API + Khung được rào | ||
Protected Audience API | Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 13 tháng 3 năm 2023 |
Riêng biệt – 1% – Chỉ Protected Audience API + Khung được rào | ||
Tổng hợp riêng tư | Hợp nhất – 1% | 1% lưu lượng truy cập ổn định kể từ ngày 17 tháng 4 năm 2023 |
Bộ nhớ dùng chung (Lựa chọn URL) | Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 13 tháng 3 năm 2023 |
Isolated – 1% – Shared Storage (URL Selection) + Fenced Frames only | ||
Chủ đề | Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% – Chỉ chủ đề |
Tháng 3 năm 2023
Cập nhật dòng thời gian
Ban đầu, chúng tôi thông báo rằng sẽ bắt đầu các thử nghiệm riêng biệt vào thứ Hai, ngày 13 tháng 3 năm 2023, nhưng các thử nghiệm mới sẽ bắt đầu vào thứ Năm, ngày 16 tháng 3 năm 2023 do cần thêm thời gian để thiết lập các thử nghiệm. Việc tăng tỷ lệ Protected Audience API từ 4% lên 5% (tức tăng thêm 1%) cũng sẽ diễn ra vào thứ Năm, ngày 16 tháng 3 năm 2023.
Tăng dần Protected Audience API lên 1%
Tháng trước, chúng tôi đã tạm thời giảm lưu lượng truy cập bản dùng thử theo nguyên gốc Protected Audience API từ 5% xuống 4% của Chrome ổn định để thử nghiệm. Thử nghiệm ban đầu đã kết thúc và chúng tôi dự định tăng Protected Audience API trở lại 5% từ 4% cho thử nghiệm hợp nhất vào thứ Năm, ngày 16 tháng 3 năm 2023.
Những người dùng được tăng dần sẽ là cùng một nhóm người dùng đã được giảm dần. Tuy nhiên, các nhóm mối quan tâm trước đây của họ đã hết hạn vì đã hơn 30 ngày kể từ khi quá trình giảm dần bắt đầu.
Thử nghiệm riêng biệt
Để cải thiện quy trình kiểm thử và tiếp tục theo dõi các chỉ số của API dùng thử nguồn gốc, chúng tôi sẽ tạo các thử nghiệm riêng biệt cho từng API, ngoài thử nghiệm hợp nhất hiện có. Các thử nghiệm mới sẽ được tạo cho Attribution Reporting API, Topics API, sự kết hợp giữa Protected Audience API và Fenced Frames, cũng như sự kết hợp giữa thao tác Lựa chọn URL của Bộ nhớ dùng chung và Fenced Frames. Trong mỗi thử nghiệm riêng biệt, người dùng trong nhóm đó sẽ chỉ sử dụng được các API được chỉ định.
API | Phân bổ lưu lượng truy cập cho thử nghiệm riêng biệt |
---|---|
Attribution Reporting | 1% |
Protected Audience API + Fenced Frames | 1% |
Shared Storage (lựa chọn URL) + Khung được rào | 1% |
Chủ đề | 1% |
Kể từ thứ Năm, ngày 16 tháng 3, bạn sẽ bắt đầu nhận thêm 1% lưu lượng truy cập Chrome ổn định cho các API nêu trên, ngoài 5% lưu lượng truy cập mà bạn đang nhận được từ thử nghiệm hợp nhất hiện có. Người dùng mới sẽ được phân bổ cho từng thử nghiệm.
Loại phân bổ lưu lượng truy cập
Phân bổ lưu lượng truy cập cho các thử nghiệm nguồn hợp nhất hiện tại tính đến thứ Ba, ngày 28 tháng 2 như sau:
API | Cách phân bổ lưu lượng truy cập của thử nghiệm hợp nhất hiện tại |
---|---|
Attribution Reporting | (5%) |
Khung bảo vệ | (5%) |
Protected Audience API | 4% |
Bộ nhớ dùng chung (lựa chọn URL) | (5%) |
Chủ đề | (5%) |
Việc phân bổ lưu lượng truy cập sẽ diễn ra như sau kể từ thứ Năm, ngày 16 tháng 3, sau khi Protected Audience API được tăng cường trở lại và các thử nghiệm biệt lập mới bắt đầu:
API | Phân bổ lưu lượng truy cập mới | Trạng thái |
---|---|---|
Attribution Reporting | Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 16 tháng 3 năm 2023 |
Isolated – 1% – Chỉ ARA | ||
Khung bảo vệ | Hợp nhất – 5% | 7% lưu lượng truy cập trên kênh Ổn định kể từ ngày 16 tháng 3 năm 2023 |
Isolated – 1% – Shared Storage (URL Selection) + Fenced Frames only | ||
Riêng biệt – 1% – Chỉ Protected Audience API + Khung được rào | ||
Protected Audience API | Hợp nhất – 5% (4% phân bổ hiện tại + 1% tăng trở lại) | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 16 tháng 3 năm 2023 |
Riêng biệt – 1% – Chỉ Protected Audience API + Khung được rào | ||
Bộ nhớ dùng chung (Lựa chọn URL) |
Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 16 tháng 3 năm 2023 |
Isolated – 1% – Shared Storage (URL Selection) + Fenced Frames only | ||
Chủ đề | Hợp nhất – 5% | 6% lưu lượng truy cập của phiên bản Ổn định kể từ ngày 16 tháng 3 năm 2023 |
Tách biệt – 1% – Chỉ chủ đề |
Những thay đổi này sẽ không ảnh hưởng đến chế độ thiết lập mã thông báo dùng thử nguồn gốc hiện tại của bạn và bạn sẽ không phải gia hạn hoặc tạo mã thông báo dùng thử nguồn gốc mới.
Tháng 1 năm 2023
Trong quá trình điều tra hồi quy của Chrome, chúng tôi sẽ tạm thời giảm lưu lượng truy cập bản dùng thử theo nguyên gốc Protected Audience API từ 5% xuống 4% của Chrome Stable, kể từ ngày 26 tháng 1 năm 2023. Chúng tôi ước tính quá trình điều tra sẽ mất khoảng một tháng và chúng tôi sẽ thông báo cho bạn khi lưu lượng truy cập tăng trở lại.
Thay đổi này sẽ tự động diễn ra và không ảnh hưởng đến mã thông báo dùng thử nguồn gốc hiện có của bạn. Đối với người dùng trong 1% lưu lượng truy cập sẽ giảm, các nhóm lợi ích sẽ vẫn còn trong trình duyệt của họ. Những người dùng này sẽ tham gia vào quá trình tăng tốc trở lại và các nhóm quan tâm của họ có thể được dùng lại. Tuy nhiên, các nhóm mối quan tâm sẽ hết hạn sau 30 ngày và quá trình điều tra hồi quy có thể mất nhiều thời gian hơn.
Ngoài ra, bản dùng thử theo nguyên gốc URL Selection API của Shared Storage sẽ tăng lên 5% lưu lượng truy cập Chrome Stable kể từ ngày 26 tháng 1 năm 2023.
API | Ghi chú |
---|---|
Attribution Reporting | Có trong phiên bản Ổn định, tăng lên 5% kể từ ngày 26 tháng 10 năm 2022. |
Chủ đề | Có trong phiên bản Ổn định, tăng lên 5% kể từ ngày 26 tháng 10 năm 2022. |
Protected Audience API | Có trong phiên bản Ổn định, tạm thời giảm xuống 4% kể từ ngày 26 tháng 1 năm 2023. |
Khung được bảo vệ | Có trong phiên bản Ổn định, tăng lên 5% kể từ ngày 9 tháng 11 năm 2022. |
Bộ nhớ dùng chung | Có trong phiên bản Ổn định, tăng 5% kể từ ngày 26 tháng 1 năm 2023. |
Tháng 11 năm 2022
API `selectURL` của Shared Storage sẽ tham gia bản dùng thử theo nguyên gốc ở mức 1% lưu lượng truy cập Chrome Stable từ ngày 9 tháng 11.
Như đã thông báo trước đây trong bài đăng trên blog Tăng tỷ lệ dùng thử theo nguyên gốc của Hộp cát về quyền riêng tư cho Mức độ liên quan và hoạt động đo lường lên 5%, Attribution Reporting API và Topics API hiện ở mức 5%, Protected Audience API và Fenced Frames cũng sẽ ở mức này kể từ ngày 9 tháng 11.
API | Ghi chú |
---|---|
Attribution Reporting | Có trong phiên bản Ổn định, tăng lên 5% kể từ ngày 26 tháng 10. |
Chủ đề | Có trong phiên bản Ổn định, tăng lên 5% kể từ ngày 26 tháng 10. |
Protected Audience API | Có trong kênh Ổn định, tăng lên 5% từ ngày 9 tháng 11. |
Khung được bảo vệ | Có trong kênh Ổn định, tăng lên 5% từ ngày 9 tháng 11. |
Bộ nhớ dùng chung | Sẽ có trong phiên bản Ổn định, bắt đầu từ 1% từ ngày 9 tháng 11. |
Tháng 10 năm 2022: Tăng 5%
Attribution Reporting API, Topics API, Protected Audience API và Fenced Frames hiện có trong Chrome Stable và sẽ nằm trong lưu lượng truy cập gia tăng.
Kể từ tuần này, chúng tôi sẽ bắt đầu tăng lưu lượng truy cập cho Báo cáo phân bổ và Chủ đề, Protected Audience API và Fenced Frames sẽ tăng từ ngày 9 tháng 11.
Đọc thêm trong bài đăng trên blog Tăng tỷ lệ dùng thử theo nguồn gốc của Hộp cát về quyền riêng tư cho Mức độ liên quan và hoạt động đo lường lên 5%.
API | Ghi chú |
---|---|
Attribution Reporting | Có trong Kênh ổn định, tăng lên 5% sau ngày 26 tháng 10. |
Chủ đề | Có trong Kênh ổn định, tăng lên 5% sau ngày 26 tháng 10. |
Protected Audience API | Có trong kênh Ổn định, tăng lên 5% từ ngày 9 tháng 11. |
Khung được bảo vệ | Có trong kênh Ổn định, tăng lên 5% từ ngày 9 tháng 11. |
Bộ nhớ dùng chung | Hiện chỉ có trên Canary, Dev và Beta từ phiên bản M105 trở lên. |
Tháng 10 năm 2022
- Bản dùng thử theo nguyên gốc đã được mở rộng sang Chrome 110.
- Bắt đầu sử dụng bản dùng thử theo nguyên gốc của Chrome giải thích cách gia hạn việc đăng ký dùng thử theo nguyên gốc. Trong đó có việc cung cấp mã thông báo mới cho các nguồn gốc tham gia. Đây là quy trình tương tự như quy trình mà mọi tiện ích dùng thử nguồn gốc khác đều tuân theo.
Việc gia hạn này nhằm cho phép hệ sinh thái có thời gian trong kênh Ổn định để tiếp tục kiểm thử và xác thực các điểm cải tiến API, đồng thời cung cấp ý kiến phản hồi nhất quán với tiến trình công khai hiện tại của chúng tôi.
Dòng thời gian tổng thể của Hộp cát về quyền riêng tư vẫn không thay đổi.
Các API có trong bản dùng thử:
API | Ghi chú |
---|---|
Báo cáo phân bổ | Hướng dẫn dành cho nhà phát triển về thử nghiệm nguồn gốc. |
Protected Audience API | Hướng dẫn dành cho nhà phát triển về thử nghiệm nguồn gốc. |
Chủ đề | Hướng dẫn dành cho nhà phát triển về thử nghiệm nguồn gốc. |
Khung được bảo vệ | Hãy xem hướng dẫn về Protected Audience API để biết cách sử dụng bản dùng thử theo nguyên gốc. |
Bộ nhớ dùng chung | Hiện chỉ có trên Canary, Dev và Beta từ phiên bản M105 trở lên. |
Tháng 8 năm 2022
- Thử nghiệm nguồn gốc sẽ tăng lên 1% người dùng máy tính từ Chrome phiên bản ổn định 104.
- Chúng tôi sẽ cập nhật khi tính năng này được cung cấp cho người dùng thiết bị di động.
- Các kênh tiền ổn định (Canary, Beta) vẫn giữ nguyên ở mức 50% người dùng.
- API không hoạt động trên Chrome cho iOS.
Tháng 5 năm 2022
Bản dùng thử theo nguyên gốc sẽ được cung cấp cho 50% người dùng Chrome 102 Beta.
Các API có trong bản dùng thử:
API | Ghi chú |
---|---|
Báo cáo phân bổ | Hướng dẫn dành cho nhà phát triển về thử nghiệm nguồn gốc. |
Protected Audience API | Hướng dẫn dành cho nhà phát triển về thử nghiệm nguồn gốc. |
Chủ đề | Hướng dẫn cho nhà phát triển về bản dùng thử nguồn gốc. Topics đã bị vô hiệu hoá trong thời gian ngắn trong giai đoạn dùng thử ban đầu do một lỗi ảnh hưởng đến tính ổn định của trình duyệt. |
Khung được bảo vệ | Đã thêm Fenced Frame vào giai đoạn dùng thử ban đầu. Xem hướng dẫn về Protected Audience API để biết cách sử dụng thử nghiệm. |
Tháng 4 năm 2022
Bản dùng thử nguồn gốc bắt đầu với một tỷ lệ nhỏ người dùng Chrome 102 Beta.
Các API có trong bản dùng thử:
API | Ghi chú |
---|---|
Báo cáo phân bổ | Bài đăng Ý định đến thử nghiệm (I2E) riêng lẻ. Báo cáo phân bổ cũng có sẵn dưới dạng một thử nghiệm nguồn riêng lẻ. |
Protected Audience API | Bài đăng Ý định đến thử nghiệm (I2E) riêng lẻ. Protected Audience API chỉ có trên máy tính và có một số chức năng. |
Chủ đề | Bài đăng Ý định đến thử nghiệm (I2E) riêng lẻ. |
Đăng ký và định cấu hình giai đoạn dùng thử nguồn gốc
Để kích hoạt thử nghiệm nguồn gốc trên trang web của mình, bạn sẽ cần đăng ký và nhúng mã thông báo thử nghiệm nguồn gốc được chỉ định (một chuỗi dựa trên thời gian cho quyền truy cập cụ thể của bạn vào thử nghiệm nguồn gốc). Tìm hiểu thêm trong phần Bắt đầu sử dụng bản dùng thử theo nguyên gốc của Chrome.
Mã thông báo dùng thử theo nguyên gốc được cấp ngay lập tức và bạn có thể thu hồi hoặc tạo lại mã thông báo này bất cứ lúc nào.
Đối với mỗi trang mà bạn muốn sử dụng bản dùng thử ban đầu, bạn sẽ cần phải thêm một mã thông báo dùng thử vào HTML hoặc phản hồi của trang cụ thể đó.
Sử dụng thẻ <meta>
trong phần <head>
của trang:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
Ngoài ra, hãy thêm tiêu đề HTTP sau vào phản hồi trang:
Origin-Trial: TOKEN_GOES_HERE
Định cấu hình bằng iframe
Nếu bạn đang sử dụng các tính năng dùng thử theo nguyên gốc trong một iframe (chẳng hạn như joinAdInterestGroup()
của Protected Audience API), thì bạn cần cung cấp mã thông báo trong iframe và mã thông báo đó phải khớp với nguồn gốc của iframe.
Định cấu hình trên nhiều trang web bằng JavaScript
Nếu đang sử dụng các tính năng dùng thử nguồn thông qua JavaScript trên nhiều trang web, tức là bạn là nhà cung cấp JavaScript của bên thứ ba có trong trang cấp cao nhất, thì bạn sẽ cần:
- Chọn lựa chọn So khớp với bên thứ ba khi đăng ký dùng thử nguồn gốc.
- Trường Nguồn gốc trên web phải là nguồn gốc của tập lệnh.
- Chèn thẻ
<meta>
vào trang cấp cao nhất (tức là trang của bên thứ nhất, không phải nội dung của riêng bạn) từ tập lệnh. Ví dụ:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Gỡ lỗi bản dùng thử theo nguyên gốc
Bạn có thể kiểm tra trạng thái của một thử nghiệm nguồn trong DevTools > bảng điều khiển Ứng dụng.

- Di chuyển xuống ngăn Khung hình.
- Chọn khung hình mà bạn dự kiến sẽ đặt mã thông báo. Ví dụ: khung trên cùng cho trang cấp cao nhất hoặc iframe cụ thể cho các trang được nhúng.
- Trong ngăn bên phải, hãy di chuyển xuống phần Origin Trials (Thử nghiệm nguồn gốc).
- Bạn sẽ thấy một mục cho gói dùng thử
PrivacySandboxAdsAPIs
. - Mở rộng mục này để xem trạng thái của thử nghiệm nguồn gốc và các mã thông báo cụ thể của bạn.
Thử nghiệm nguồn gốc chỉ dành cho một số ít người dùng Chrome và trình duyệt của bạn có thể không nằm trong nhóm thử nghiệm. Do đó, bạn có thể thấy thông báo màu đỏ TrialNotAllowed
đối với PrivacySandboxAdsAPIs
. Khi bạn mở rộng mục nhập để kiểm tra Trạng thái mã thông báo, nếu mục này cho thấy thông báo Success
màu xanh lục, thì cấu hình dùng thử theo nguồn gốc của bạn là chính xác. Người dùng đủ điều kiện sẽ thấy thông báo được đặt thành Enabled
.

Nếu bạn thấy các thông báo khác, hãy tham khảo bài viết Khắc phục sự cố liên quan đến các thử nghiệm nguồn gốc của Chrome để xem danh sách kiểm tra chi tiết nhằm xác thực cấu hình của thử nghiệm nguồn gốc.
Phát hiện các đối tượng
Giống như tất cả các tính năng trên web, bạn nên kiểm tra xem các tính năng đó có báo cáo là có sẵn trong trình duyệt hay không trước khi cố gắng sử dụng. Bạn có thể thực hiện việc này bằng cách kiểm tra sự tồn tại của API có liên quan ở đúng vị trí:
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
}
Xác định điều kiện của người dùng
Thử nghiệm nguồn đang diễn ra cho một phần nhỏ người dùng Chrome. Họ cũng phải bật chức năng liên quan trong phần cài đặt để đủ điều kiện dùng thử:
Cài đặt trình duyệt
Để đủ điều kiện dùng thử, người dùng phải:
Sử dụng phiên bản và kênh của Chrome nơi đang chạy bản dùng thử theo nguyên gốc.
- Hãy xem Trạng thái dùng thử nguồn gốc để biết các cấu hình hiện tại.
Nằm trong nhóm thử nghiệm đang hoạt động trong Chrome.
Chế độ cài đặt cho người dùng
Để đủ điều kiện dùng thử, người dùng cũng phải:
- bật chế độ dùng thử Hộp cát về quyền riêng tư thông qua phần Cài đặt > Bảo mật và quyền riêng tư > Hộp cát về quyền riêng tư, bạn cũng có thể truy cập thông qua biểu tượng
chrome://settings/adPrivacy
. - bật cookie của bên thứ ba thông qua phần Cài đặt > Bảo mật và quyền riêng tư > Cookie và các dữ liệu khác của trang web được đặt thành "Cho phép tất cả cookie" hoặc "Chặn cookie của bên thứ ba ở chế độ ẩn danh", cũng có thể truy cập thông qua biểu tượng
chrome://settings/cookies
. - ở trong một phiên duyệt web thông thường và không ở Chế độ ẩn danh.
Mặc dù thử nghiệm nguồn gốc sẽ chỉ hiển thị dưới dạng đang hoạt động cho người dùng đủ điều kiện, nhưng bạn cũng có thể sử dụng cờ dành cho nhà phát triển để kiểm thử trên trang web sản xuất của riêng mình.
Kiểm soát việc bạn tham gia thử nghiệm nguồn gốc
Cơ chế của bản dùng thử theo nguyên gốc vẫn giữ nguyên: bạn nhận được mã thông báo dùng thử theo nguyên gốc cho những bối cảnh mà bạn muốn thử nghiệm API. Với nhóm người dùng thử nghiệm mở rộng, bạn phải đảm bảo rằng bạn đang chủ động theo dõi và kiểm soát mức lưu lượng truy cập khi chọn bật thử nghiệm.
Một cách tiếp cận phù hợp là:
- Theo mặc định, hãy thêm mã thông báo dùng thử nguồn vào tất cả các ngữ cảnh mà bạn muốn thử nghiệm.
- Sử dụng tính năng phát hiện để kiểm tra các API đang hoạt động.
- Nếu các API đang hoạt động (do đó, trình duyệt đủ điều kiện tham gia thử nghiệm này), hãy chọn có sử dụng các API đó hay không dựa trên tiêu chí thử nghiệm của riêng bạn. Ví dụ: nếu đã có cơ sở hạ tầng thử nghiệm A/B để thử nghiệm trên một tỷ lệ phần trăm lưu lượng truy cập, lấy mẫu hoặc một số thuộc tính khác, thì tại thời điểm này, bạn có thể quyết định những tính năng mà bạn sẽ chủ động sử dụng.
Bạn có thể ngăn hoàn toàn việc tham gia thử nghiệm nguồn cho mọi phiên bản trình duyệt bằng cách không đưa mã thông báo vào phản hồi. Ví dụ: nếu bạn đã đạt đến hạn mức của riêng mình cho một thử nghiệm hoặc cần giải quyết một vấn đề trong thời gian dùng thử, thì việc không thêm mã thông báo sẽ đảm bảo không có chức năng thử nghiệm nào có sẵn hoặc hoạt động trên trang.
Kiểm soát bản dùng thử theo nguyên gốc theo khu vực địa lý
Bạn không thể chọn không tham gia dùng thử nguồn cho các khu vực cụ thể. Thử nghiệm nguồn đang hoạt động trên những trang chứa mã thông báo, được đưa vào thông qua tiêu đề HTTP (phía máy chủ) hoặc thẻ meta HTML (phía máy khách).
Nếu có thể xác định vị trí của người dùng, thì bạn có thể viết mã để đưa mã thông báo dùng thử nguồn gốc dựa trên thông tin vị trí đó. Ví dụ: bạn có thể cố gắng sử dụng địa chỉ IP để xác định vị trí của người dùng. Địa chỉ IP có thể bị giả mạo, vì vậy đây không phải là một giải pháp đảm bảo.
Tuy nhiên, một nguồn gốc theo địa lý cụ thể có thể đặt một Permissions Policy (Chính sách về quyền) để kiểm soát những tính năng có thể sử dụng. Ví dụ: us.example.com
và uk.example.com
là các nguồn gốc theo khu vực địa lý mà bạn có thể kiểm soát. Điều này không có nghĩa là một khu vực đã chọn không tham gia bản dùng thử theo nguyên gốc.
Với Chính sách về các quyền, một trang web sẽ thêm một đoạn mã nhỏ vào các trang của mình để cung cấp hướng dẫn cho trình duyệt. Khi trang tải, trình duyệt sẽ đọc các hướng dẫn trong Chính sách về quyền và cho phép hoặc chặn các tính năng (hoặc API) như được nêu trong Chính sách về quyền. Nếu một trang web muốn hạn chế một API ở một khu vực cụ thể, nhà phát triển có thể đặt một chính sách cho tất cả các trang được yêu cầu từ khu vực đó.
Gia hạn mã thông báo
Mã thông báo dùng thử nguồn gốc sẽ hết hạn sau 6 tuần kể từ ngày phát hành (hoặc khi kết thúc giai đoạn dùng thử nếu giai đoạn này kết thúc sớm hơn).
Điều quan trọng là bạn phải gia hạn và triển khai mã thông báo mới trong khoảng thời gian đó để sử dụng các tính năng trong giai đoạn dùng thử nguồn gốc mà không bị gián đoạn.
Việc làm mới mã thông báo chỉ mất vài phút và bạn có thể triển khai nhiều mã thông báo cho cùng một bản dùng thử trong cùng một trang. Bạn có thể triển khai mã thông báo mới trước khi mã thông báo hiện tại hết hạn, vì vậy, người dùng sẽ không bị gián đoạn dịch vụ.
Kiểm thử cục bộ
Để biết hướng dẫn cụ thể về kiểm thử của nhà phát triển tại địa phương, hãy xem:
Theo mặc định, các API này ở trạng thái tắt và phải được bật bằng cờ để kiểm thử. Bạn nên đảm bảo rằng bạn đã bật cùng chế độ cài đặt cấu hình ở trên, sau đó:
- Sử dụng phiên bản và kênh của Chrome có các tính năng này.
- Bật tất cả các API Quyền riêng tư trong quảng cáo trong
chrome://settings/adPrivacy
.
Hãy xem hướng dẫn dành cho nhà phát triển để biết thông tin về tính sẵn có của các API và tính năng cụ thể, cũng như các cờ bổ sung để có cấu hình chi tiết hơn.