Chủ đề, Khung bảo vệ và Bộ nhớ dùng chung. từ khoá: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
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 mang đến cơ hội để 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 thực tế. Bản dùng thử theo nguyên gốc Độ liên quan và đo lường trong 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 Báo cáo phân bổ, Protected Audience API, Chủ đề, Khung bảo vệ và Bộ nhớ dùng chung. Nhà phát triển có thể đăng ký bản dùng thử theo nguyên gốc này để kiểm thử trên các API Chủ đề, 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 các 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 các API.
Kiểm tra trạng thái của bản dùng thử theo nguyên gốc
Tháng 6 năm 2023
Tăng 7% số lượt sử dụng tính năng Tổng hợp riêng tư trong phiên bản ổn định
Private Aggregation API sẽ được cung cấp cho 7% lưu lượng truy cập Chrome phiên bản ổn định kể từ thứ Ba, ngày 6 tháng 6 năm 2023. API này sẽ có trong nhóm thử nghiệm theo nguyên gốc hợp nhất chính (5%), nhóm riêng biệt Protected Audience (1%) và nhóm riêng biệt Shared Storage (1%). Việc phân bổ lưu lượng truy cập cho Protected Audience và Bộ nhớ dùng chung sẽ không thay đổi vì tính năng Tổng hợp riêng tư đ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 kể từ ngày 13 tháng 3 năm 2023 |
| Biệt lập – 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 |
| Riêng biệt – 1% – Chỉ có Bộ nhớ dùng chung + Tổng hợp riêng tư + Khung bảo vệ | ||
| Riêng biệt – 1% – Chỉ Protected Audience + Tổng hợp riêng tư + Khung bảo vệ | ||
| Protected Audience | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định kể từ ngày 13 tháng 3 năm 2023 |
| Riêng biệt – 1% – Chỉ Protected Audience + Tổng hợp riêng tư + Khung bảo vệ | ||
| Tổng hợp riêng tư | Hợp nhất – 5% | 7% lưu lượng truy cập ổn định kể từ ngày 6 tháng 6 năm 2023 |
| Riêng biệt – 1% – Chỉ Protected Audience + Tổng hợp riêng tư + Khung bảo vệ | ||
| Riêng biệt – 1% – Chỉ có 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 kể từ ngày 13 tháng 3 năm 2023 |
| Riêng biệt – 1% – Chỉ có 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 kể từ ngày 13 tháng 3 năm 2023 |
| Riêng 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 theo nguyên gốc.
Tháng 4 năm 2023
Tăng 1% tính năng Tổng hợp riêng tư trong phiên bản ổn định
Bản dùng thử theo nguyên gốc Private Aggregation API sẽ được cung cấp cho 1% lưu lượng truy cập thử nghiệm hợp nhất của Chrome phiên bản ổn định kể từ thứ Hai, ngày 17 tháng 4. Bạn có thể sử dụng hàm sendHistogramReport() của tính năng Tổng hợp riêng tư trong các công việc Protected Audience API và 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 ổn định kể từ ngày 13 tháng 3 năm 2023 |
| Biệt lập – 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 |
| Riêng biệt – 1% – Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ Khung được phân vùng | ||
| Riêng biệt – 1% – Chỉ Protected Audience API + Khung được phân vùng | ||
| Protected Audience API | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định kể từ ngày 13 tháng 3 năm 2023 |
| Riêng biệt – 1% – Chỉ Protected Audience API + Khung được phân vùng | ||
| 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 ổn định kể từ ngày 13 tháng 3 năm 2023 |
| Riêng biệt – 1% – Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ Khung được phân vùng | ||
| Chủ đề | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định kể từ ngày 13 tháng 3 năm 2023 |
| Riêng biệt – 1% – Chỉ chủ đề |
Tháng 3 năm 2023
Thông tin cập nhật về tiến trình
Ban đầu, chúng tôi thông báo rằng chúng tôi 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. Tuy nhiên, 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 Protected Audience API thêm 1% từ 4% lên 5% cũng sẽ diễn ra vào thứ Năm, ngày 16 tháng 3 năm 2023.
Tăng dần 1% Protected Audience API
Tháng trước, chúng tôi tạm thời giảm lưu lượng truy cập trong bản dùng thử theo nguyên gốc Protected Audience API từ 5% xuống 4% trên phiên bản Chrome ổn định để thử nghiệm. Chúng tôi đã kết thúc thử nghiệm ban đầu và dự định tăng Protected Audience API từ 4% lên 5% 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 cường sẽ là cùng một nhóm người dùng đã được giảm cường độ. 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 chúng tôi giảm dần.
Thử nghiệm riêng biệt
Để cải thiện quy trình kiểm thử và tiếp tục quan sát các chỉ số của API thử nghiệm nguồn gốc, chúng tôi đang 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ó. Chúng tôi sẽ tạo các thử nghiệm mới cho tính năng Báo cáo phân bổ, Chủ đề, kết hợp Protected Audience API và Khung bảo vệ, cũng như kết hợp thao tác Lựa chọn URL của Bộ nhớ dùng chung và Khung bảo vệ. Trong mỗi thử nghiệm riêng biệt, người dùng trong nhóm đó chỉ có thể sử dụng các API được chỉ định.
| API | Phân bổ lưu lượng truy cập của thử nghiệm riêng biệt |
|---|---|
| Attribution Reporting | 1% |
| Protected Audience API + Khung được phân cách | 1% |
| Bộ nhớ dùng chung (lựa chọn URL) + Khung được phân vùng | 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 phiên bản ổn định cho các API nêu trên, ngoài 5% lưu lượng truy cập 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ổ vào 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 thử nghiệm nguồn gốc hợp nhất hiện tại kể từ thứ Ba, ngày 28 tháng 2 như sau:
| API | 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 riêng biệt 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 ổn định kể từ ngày 16 tháng 3 năm 2023 |
| Biệt lập – 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 16 tháng 3 năm 2023 |
| Riêng biệt – 1% – Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ Khung được phân vùng | ||
| Riêng biệt – 1% – Chỉ Protected Audience API + Khung được phân vùng | ||
| Protected Audience API | Hợp nhất – 5% (4% mức phân bổ hiện tại + 1% mức tăng trở lại) | 6% lưu lượng truy cập ổn định kể từ ngày 16 tháng 3 năm 2023 |
| Riêng biệt – 1% – Chỉ Protected Audience API + Khung được phân vùng | ||
| Bộ nhớ dùng chung (Lựa chọn URL) |
Hợp nhất – 5% | 6% lưu lượng truy cập ổn định kể từ ngày 16 tháng 3 năm 2023 |
| Riêng biệt – 1% – Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ Khung được phân vùng | ||
| Chủ đề | Hợp nhất – 5% | 6% lưu lượng truy cập ổn định kể từ ngày 16 tháng 3 năm 2023 |
| Riêng 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 thử nghiệm 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 thử nghiệm 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 trong bản dùng thử theo nguyên gốc Protected Audience API từ 5% xuống 4% trên Chrome phiên bản ổn định, kể từ ngày 26 tháng 1 năm 2023. Theo ướ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ử gốc hiện có của bạn. Đối với những người dùng thuộc 1% lưu lượng truy cập sẽ giảm dần, các nhóm mối quan tâm sẽ vẫn còn trong trình duyệt của họ. Những người dùng này sẽ được đưa vào quá trình tăng dần và bạn có thể sử dụng lại các nhóm mối quan tâm của họ. 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 Bộ nhớ dùng chung sẽ tăng lên 5% lưu lượng truy cập Chrome phiên bản ổn định kể từ ngày 26 tháng 1 năm 2023.
| API | Ghi chú |
|---|---|
| Báo cáo phân bổ | 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 còn 4% kể từ ngày 26 tháng 1 năm 2023. |
| Khung 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 Bộ nhớ dùng chung sẽ tham gia bản dùng thử theo nguyên gốc với 1% lưu lượng truy cập Chrome phiên bản ổn định kể từ ngày 9 tháng 11.
Như đã thông báo trước đó trong bài đăng trên blog Tăng tỷ lệ thử nghiệm theo nguyên gốc về Mức độ liên quan và Đo lường trong Hộp cát về quyền riêng tư lên 5%, Attribution Reporting và Topics hiện ở mức 5%, còn Protected Audience API và Khung bảo vệ cũng sẽ tăng lên mức này vào ngày 9 tháng 11.
| API | Ghi chú |
|---|---|
| Báo cáo phân bổ | 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 phiên bản ổn định, tăng lên 5% kể từ ngày 9 tháng 11. |
| Khung bảo vệ | Có trong phiên bản ổn định, tăng lên 5% kể 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%
Báo cáo phân bổ, Chủ đề, Protected Audience API và Khung bảo vệ hiện đều có trong Chrome phiên bản ổn định và sẽ là một phần của lưu lượng truy cập tăng lên.
Kể từ tuần này, chúng tôi sẽ bắt đầu tăng lưu lượng truy cập cho tính năng Báo cáo phân bổ và Chủ đề. Protected Audience API và Khung bảo vệ sẽ tăng từ ngày 9 tháng 11.
Hãy đọc thêm trong bài đăng trên blog Tăng tỷ lệ thử nghiệm nguồn gốc Đo lường và Mức độ liên quan của Hộp cát về quyền riêng tư lên 5%.
| API | Ghi chú |
|---|---|
| Báo cáo phân bổ | Có trong phiên bản ổn định, tăng lên 5% sau ngày 26 tháng 10. |
| Chủ đề | Có trong phiên bản ổn định, tăng lên 5% sau ngày 26 tháng 10. |
| Protected Audience API | Có trong phiên bản ổn định, tăng lên 5% kể từ ngày 9 tháng 11. |
| Khung bảo vệ | Có trong phiên bản ổn định, tăng lên 5% kể từ ngày 9 tháng 11. |
| Bộ nhớ dùng chung | Hiện chỉ có trong M105+ Canary, Dev và Beta. |
Tháng 10 năm 2022
- Bản dùng thử theo nguyên gốc đã được mở rộng cho Chrome 110.
- Bài viết 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 gói đăng ký bản dùng thử theo nguyên gốc. Điều này bao gồm việc cung cấp mã thông báo mới cho các nguồn gốc tham gia. Đây cũng là quy trình mà mọi tiện ích thử nghiệm nguồn gốc khác đều tuân theo.
Chúng tôi đã cấp thời gian gia hạn này để hệ sinh thái trong kênh ổn định có thể tiếp tục thử nghiệm và xác thực các điểm cải tiến về API, đồng thời cung cấp 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.
Tiến trình chung của Hộp cát về quyền riêng tư vẫn giữ nguyên.
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 gốc. |
| Protected Audience API | Hướng dẫn dành cho nhà phát triển về thử nghiệm gốc. |
| Chủ đề | Hướng dẫn dành cho nhà phát triển về thử nghiệm gốc. |
| Khung bảo vệ | Xem hướng dẫn về Protected Audience API để sử dụng bản dùng thử theo nguyên gốc. |
| Bộ nhớ dùng chung | Hiện chỉ có trong M105+ Canary, Dev và Beta. |
Tháng 8 năm 2022
- Thử nghiệm Origin được cung cấp cho 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.
- Kênh trước khi phát hành phiên bả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 dành cho iOS.
Tháng 5 năm 2022
Tăng phạm vi cung cấp bản dùng thử theo nguyên gốc lên 50% người dùng từ 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 gốc. |
| Protected Audience API | Hướng dẫn dành cho nhà phát triển về thử nghiệm gốc. |
| Chủ đề | Hướng dẫn dành cho nhà phát triển về thử nghiệm gốc. Chủ đề đã bị tắt trong thời gian ngắn trong thử nghiệm gốc do lỗi ảnh hưởng đến độ ổn định của trình duyệt. |
| Khung bảo vệ | Thêm Khung được phân vùng vào thử nghiệm gốc. 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ử theo nguyên gốc bắt đầu với một tỷ lệ người dùng giới hạn từ 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 thử nghiệm (I2E) riêng lẻ. Bạn cũng có thể sử dụng Báo cáo phân bổ dưới dạng thử nghiệm nguồn gốc riêng lẻ. |
| Protected Audience API | Bài đăng Ý định thử nghiệm (I2E) riêng lẻ. Protected Audience API chỉ có trên máy tính với một nhóm chức năng. |
| Chủ đề | Bài đăng Ý định thử nghiệm (I2E) riêng lẻ. |
Đăng ký và định cấu hình bản dùng thử theo nguyên gốc
Để kích hoạt bản dùng thử theo nguồn gốc trên trang web của mình, bạn cần đăng ký và nhúng mã thông báo dùng thử theo 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 bản dùng thử theo 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 đó bất cứ lúc nào.
Đối với mỗi trang mà bạn muốn sử dụng thử nghiệm gốc, bạn cần thêm một mã thông báo thử nghiệm 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 thử nghiệm theo nguyên gốc trong một iframe (chẳng hạn như joinAdInterestGroup() của Protected Audience API), thì mã thông báo cần được cung cấp trong iframe và 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 thử nghiệm theo nguyên gốc 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 cần:
- Chọn tuỳ chọn So khớp bên thứ ba khi đăng ký thử nghiệm nguồn gốc.
- Trường Nguồn gốc 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 bản dùng thử theo nguyên gốc trong bảng điều khiển DevTools > Applications (Công cụ phát triển > Ứng dụng).
- Di chuyển xuống ngăn Frames (Khung).
- Chọn khung 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 mục Origin Trials (Thử nghiệm theo nguyên gốc).
- Bạn sẽ thấy một mục nhập cho bản dùng thử
PrivacySandboxAdsAPIs. - Mở rộng mục này để xem trạng thái của thử nghiệm gốc và mã thông báo cụ thể của bạn.
Bản dùng thử theo 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 thuộc nhóm thử nghiệm. Do đó, bạn có thể thấy thông báo TrialNotAllowed màu đỏ đố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 nhập này hiển thị thông báo Success màu xanh lục, thì cấu hình thử nghiệm 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ố về thử nghiệm 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 gốc.
Phát hiện các tính năng
Giống như tất cả các tính năng 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 xem API có liên quan có tồn tại ở đúng vị trí hay không:
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 xem người dùng có đủ điều kiện hay không
Bản dùng thử theo nguyên gốc đang chạy cho một số ít người dùng Chrome. Người dùng cũng phải bật chức năng liên quan trong phần cài đặt để đủ điều kiện sử dụng bả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 đang chạy bản dùng thử theo nguyên gốc.
- Xem phần Trạng thái thử nghiệm 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ư, cũng có thể truy cập thông qua
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, đặt thành "Cho phép tất cả cookie" hoặc "Chặn cookie của bên thứ ba trong chế độ ẩn danh", cũng có thể truy cập thông qua
chrome://settings/cookies. - đang ở phiên duyệt web thông thường và không phải ở Chế độ ẩn danh.
Mặc dù bản dùng thử gốc sẽ chỉ hiển thị là đang hoạt động đối với những 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 chính thức của mình.
Kiểm soát việc tham gia thử nghiệm về 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 sẽ nhận được mã thông báo bản dùng thử theo nguyên gốc cho các ngữ cảnh mà bạn muốn thử nghiệm với các API. Với nhóm 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 mà bạn chọn bật chương trình dùng thử.
Bạn nên làm như sau:
- Thêm mã thông báo thử nghiệm gốc theo mặc định trong tất cả ngữ cảnh mà bạn muốn thử nghiệm.
- Sử dụng tính năng phát hiện tính năng để kiểm tra các API đang hoạt động.
- Nếu các API đang hoạt động (và 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 theo 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 gốc cho bất kỳ phiên bản trình duyệt nào 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 hạn mức của riêng mình cho một thử nghiệm hoặc cần giải quyết vấn đề trong quá trình thử nghiệm, thì việc không đưa mã thông báo vào sẽ đảm bảo không có chức năng thử nghiệm nào hoạt động hoặc có sẵn trong 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 chương trình dùng thử theo nguyên gốc cho một số khu vực cụ thể. Bản dùng thử theo nguồn gốc hoạt động trên các 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ử gốc vào 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à giải pháp đảm bảo.
Tuy nhiên, một nguồn gốc theo vị trí địa lý cụ thể có thể đặt Chính sách 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 vị trí địa lý có thể được 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 quyền, 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 hướng dẫn trong Chính sách quyền và sẽ 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 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 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ử Origin sẽ hết hạn sau 6 tuần kể từ ngày phát hành (hoặc vào cuối thời gian dùng thử nếu thời gian đó đến 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 liên tục các tính năng thử nghiệm theo nguyên gốc.
Việc gia hạn 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 đã gia hạn trước khi mã thông báo hiện tại hết hạn để người dùng 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ề việc kiểm thử cục bộ cho nhà phát triển, hãy xem:
Các API này không bật theo mặc định và phải được bật bằng cờ để kiểm thử. Bạn cần đảm bảo rằng bạn đã bật các chế độ cài đặt cấu hình giống 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ả API Quyền riêng tư trong quảng cáo trong
chrome://settings/adPrivacy.
Hãy kiểm tra hướng dẫn dành cho nhà phát triển để biết 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.