Chủ đề, Khung bảo vệ và Bộ nhớ dùng chung. từ khoá: sản phẩm:Hộp cát về quyền riêng tư, tài liệu:Hướng dẫn, topicAdSetup, contentTypeSolution, danh mục:Web, apiGroupAds, audienceAd Buyer, audienceAdSeller, audienceAdMeasurementProvider, kỹ năng:mới bắt đầu
Hộp cát về quyền riêng tư bao gồm một số đề xuất cho phép sử dụng quảng cáo trường hợp mà không cần theo dõi trên nhiều trang web. Nguồn gốc thử nghiệm tạo ra cơ hội để nhà phát triển đánh giá và cung cấp phản hồi về các công nghệ web mới thông qua thử nghiệm thực tế. Chiến lược phát hành đĩa đơn Mức độ liên quan và Bản dùng thử theo nguyên gốc đo lường cung cấp bản dùng thử duy nhất cho phép các trang web chạy 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à Chia sẻ Bộ nhớ. Nhà phát triển có thể đăng ký bản dùng thử theo nguyên gốc duy nhất này để bạn có thể kiểm thử trên Topics API, Protected Audience API và Attribution Reporting API. Chiến dịch này 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 API, cho bạn biết cách xác thực cấu hình của bạn 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 hợp riêng tư 7% tăng dần trong phiên bản Ổn định
API Tổng hợp riêng tư sẽ là ở mức 7% lưu lượng truy cập trang Chrome ổn định từ thứ Ba, ngày 6 tháng 6 năm 2023. API sẽ có trong nhóm dùng thử theo nguyên gốc hợp nhất chính (5%), Protected Nhóm tách biệt đối tượng (1%) và nhóm tách biệt Bộ nhớ dùng chung (1%). Chiến lược phát hành đĩa đơn cách 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ó.
Mức phân bổ lưu lượng truy cập tính đến 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 |
Tách biệt – 1% – chỉ ARA | ||
Khung bảo vệ | Hợp nhất – 5% | 7% 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% – Bộ nhớ dùng chung + Tổng hợp riêng tư + Chỉ khung bảo vệ | ||
Tách biệt – 1% – Đối tượng được bảo vệ + Tính năng 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 tính đến ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% – Đối tượng được bảo vệ + Tính năng 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 tính đến ngày 6/6/2023 |
Tách biệt – 1% – Đối tượng được bảo vệ + Tính năng tổng hợp riêng tư + Khung bảo vệ | ||
Tách biệt – 1% – Bộ nhớ dùng chung + Tổng hợp riêng tư + Chỉ 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 |
Tách biệt – 1% – Bộ nhớ dùng chung + Tổng hợp riêng tư + Chỉ 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
Hãy xem thông tin cập nhật trước đây về bản dùng thử theo nguyên gốc.
Tháng 4 năm 2023
Tổng hợp riêng tư 1% tăng dần trong phiên bản Ổn định
Mã Riêng tư
Bản dùng thử theo nguyên gốc API tổng hợp sẽ được cung cấp cho 1% phiên bản Chrome ổn định
lưu lượng truy cập thử nghiệm hợp nhất từ thứ Hai ngày 17 tháng 4. sendHistogramReport()
chức năng Tổng hợp riêng tư có thể dùng trong Protected Audience API
và Bộ nhớ dùng chung
Worklet.
Kể từ thứ Hai, ngày 17 tháng 4, mức phân bổ lưu lượng truy cập sẽ có dạng như sau:
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 bắt đầu từ ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% – chỉ ARA | ||
Khung bảo vệ | Hợp nhất – 5% | 7% Lưu lượng truy cập ổn định bắt đầu từ ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% - Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ khung có bảo vệ | ||
Tách biệt – 1% – chỉ dành cho Protected Audience API + Khung bảo vệ | ||
Protected Audience API | Hợp nhất – 5% | 6% Lưu lượng truy cập ổn định bắt đầu từ ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% – chỉ dành cho Protected Audience API + Khung bảo vệ | ||
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 bắt đầu từ ngày 13 tháng 3 năm 2023 |
Tách biệt – 1% - Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ khung có bảo vệ | ||
Chủ đề | Hợp nhất – 5% | 6% Lưu lượng truy cập ổn định bắt đầu 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 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, 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 thử nghiệm. 1% Quá trình tăng tốc độ sao lưu của Protected Audience API 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.
Sao lưu Protected Audience API 1%
Tháng trước, chúng tôi đã tạm thời giảm lưu lượng truy cập của bản dùng thử theo nguyên gốc Protected Audience API từ 5% xuống còn 4% của Chrome ổn định cho quá trình thử nghiệm. Quá trình thử nghiệm ban đầu đã kết thúc và chúng tôi dự định sẽ tăng tốc độ phục hồi của Protected Audience API lên 5% từ mức 4% cho thử nghiệm hợp nhất vào thứ Năm, ngày 16 tháng 3 năm 2023.
Nhóm người dùng tăng dần sẽ giống với nhóm người dùng giảm dần. Tuy nhiên, các nhóm đối tượng có cùng mối quan tâm trước đây đã hết hạn vì đã hơn 30 ngày kể từ khi lệnh ngừng hoạt động này.
Thử nghiệm tách biệt
Để cải thiện quy trình thử nghiệm và tiếp tục quan sát các chỉ số của API dùng thử theo nguyê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 (Báo cáo phân bổ), Topics (Chủ đề), kết hợp Protected Audience API và Khung bảo vệ, cũng như tổ hợp thao tác 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, chỉ người dùng trong nhóm đó mới có thể sử dụng các API được chỉ định.
API | Phân bổ lưu lượng truy cập thử nghiệm tách biệt |
---|---|
Attribution Reporting | 1% |
Protected Audience API + Khung bảo vệ | 1% |
Bộ nhớ dùng chung (lựa chọn URL) + Khung bảo vệ | 1% |
Chủ đề | 1% |
Bắt đầu từ thứ Năm, ngày 16 tháng 3, bạn sẽ bắt đầu nhận được thêm 1% Lưu lượng truy cập ổn định của Chrome cho các API được liệt kê ở 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 mỗi thử nghiệm.
Loại phân bổ lưu lượng truy cập
Mô hình phân bổ lưu lượng dùng thử nguồn gốc thống 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 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%) |
Kể từ thứ Năm, ngày 16 tháng 3, mức phân bổ lưu lượng truy cập sẽ có dạng như sau, sau khi Protected Audience API hoạt động trở lại và các thử nghiệm riêng biệt mới sẽ bắt đầu:
API | Cách 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 bắt đầu từ ngày 16 tháng 3 năm 2023 |
Tách biệt – 1% – chỉ ARA | ||
Khung bảo vệ | Hợp nhất – 5% | 7% Lưu lượng truy cập ổn định bắt đầu từ ngày 16 tháng 3 năm 2023 |
Tách biệt – 1% - Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ khung có bảo vệ | ||
Tách biệt – 1% – chỉ dành cho Protected Audience API + Khung bảo vệ | ||
Protected Audience API | Hợp nhất – 5% (4% phân bổ hiện tại + 1% tăng tốc) | 6% Lưu lượng truy cập ổn định bắt đầu từ ngày 16 tháng 3 năm 2023 |
Tách biệt – 1% – chỉ dành cho Protected Audience API + Khung bảo vệ | ||
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 bắt đầu từ ngày 16 tháng 3 năm 2023 |
Tách biệt – 1% - Bộ nhớ dùng chung (Lựa chọn URL) + Chỉ khung có bảo vệ | ||
Chủ đề | Hợp nhất – 5% | 6% Lưu lượng truy cập ổn định bắt đầu 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 cách thiết lập mã dùng thử theo nguyê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ử theo nguyên gốc mới.
Tháng 1 năm 2023
Trong quá trình điều tra sự hồi quy của Chrome, chúng tôi sẽ tạm thời giảm lưu lượng truy cập của bản dùng thử theo nguyên gốc Protected Audience API từ 5% xuống còn 4% của Bản ổn định của Chrome, kể từ ngày 26 tháng 1 năm 2023. Chúng tôi ước tính quá trình điều tra này 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 được khôi phục.
Thay đổi này sẽ tự động diễn ra và sẽ không ảnh hưởng đến các mã thông báo bản dùng thử theo nguyê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 dần, 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 đó sẽ là một phần của quá trình tăng cường trở lại và nhóm mối quan tâm của họ có thể được sử dụng lại. Tuy nhiên, các nhóm quan tâm đó sẽ hết hạn trong 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 API lựa chọn URL của Bộ nhớ dùng chung sẽ tăng lên 5% lưu lượng truy cập Bản ổn định của Chrome kể từ ngày 26 tháng 1 năm 2023.
API | Ghi chú |
---|---|
Báo cáo phân bổ | Mức giá có sẵn trong phiên bản ổn định, tăng lên 5% từ ngày 26 tháng 10 năm 2022. |
Chủ đề | Mức giá có sẵn trong phiên bản ổn định, tăng lên 5% từ ngày 26 tháng 10 năm 2022. |
Protected Audience API | Gói này có trong phiên bản ổn định, tạm thời giảm xuống còn 4% từ ngày 26 tháng 1 năm 2023. |
Khung bảo vệ | Mức giá có sẵn trong phiên bản ổn định, tăng lên 5% từ ngày 9 tháng 11 năm 2022. |
Bộ nhớ dùng chung | Có sẵn 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 ở mức 1% lưu lượng truy cập chính thức của Chrome từ ngày 9 tháng 11.
Như đã thông báo trước đây trong bài đăng trên blog Tăng mức độ liên quan của bản dùng thử theo nguyên gốc Hộp cát về quyền riêng tư lên 5%, tính năng Báo cáo phân bổ và Chủ đề hiện ở mức 5% với Protected Audience API và tính năng Khung bảo vệ cũng diễn ra sau ngày 9 tháng 11.
API | Ghi chú |
---|---|
Báo cáo phân bổ | Mức giá có trong phiên bản ổn định, đã tăng lên 5% từ ngày 26 tháng 10. |
Chủ đề | Mức giá có trong phiên bản ổn định, đã tăng lên 5% từ ngày 26 tháng 10. |
Protected Audience API | Có sẵn trong Kênh chính thức, tăng lên 5% từ ngày 9 tháng 11. |
Khung bảo vệ | Có sẵn trong Kênh chính thức, tăng lên 5% từ ngày 9 tháng 11. |
Bộ nhớ dùng chung | Gói này sẽ có trong phiên bản ổn định, với mức giá bắt đầu là 1% từ ngày 9 tháng 11. |
Tháng 10 năm 2022: tăng 5%
Attribution Reporting, Topics API, Protected Audience API và Khung bảo vệ hiện đều có trong Bản ổn định của Chrome và sẽ là một phần trong lưu lượng truy cập gia tăng 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ủ đề kể từ tuần này, Protected Audience API và Khung bảo vệ sẽ tăng lên kể từ ngày 9 tháng 11.
Vui lòng đọc thêm trong bài đăng trên blog Tăng mức độ liên quan của bản dùng thử theo nguyên gốc 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 gói ổn định, tăng lên 5% sau ngày 26 tháng 10. |
Chủ đề | Có trong gói ổn định, tăng lên 5% sau ngày 26 tháng 10. |
Protected Audience API | Có sẵn trong Kênh chính thức, tăng lên 5% từ ngày 9 tháng 11. |
Khung bảo vệ | Có sẵn trong Kênh chính thức, tăng lên 5% từ ngày 9 tháng 11. |
Bộ nhớ dùng chung | Hiện chỉ có trong phiên bản 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.
- Làm quen với 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ý bản dùng thử theo nguyên gốc. Việc 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. Quy trình này cũng tương tự như mọi tiện ích dùng thử theo nguyên gốc khác.
Chúng tôi phê duyệt việc gia hạn này để hệ sinh thái có thời gian ở Kênh chính thức 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 đưa ra ý kiến phản hồi đều phù hợp với dòng thời gian công khai hiện tại của chúng tôi.
Tiến trình 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ú |
---|---|
Phân bổ Báo cáo | Nhà phát triển hướng dẫn dùng thử theo nguyên gốc. |
Protected Audience API | Nhà phát triển hướng dẫn dùng thử theo nguyên gốc. |
Chủ đề | Nhà phát triển hướng dẫn dùng thử theo nguyên gốc. |
Có hàng rào Khung | 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. |
Được chia sẻ Bộ nhớ | Hiện chỉ có trong phiên bản M105+ Canary, Dev và Beta. |
Tháng 8 năm 2022
- Khả năng sử dụng bản dùng thử theo nguyên gốc sẽ tăng tới 1% người dùng máy tính từ Chrome Stable 104.
- Chúng tôi sẽ cập nhật ứng dụng khi phạm vi cung cấp bao gồm cả người dùng thiết bị di động.
- Kênh trước ổn định (Canary, Beta) vẫn chiếm 50% số người dùng.
- API không hoạt động trên Chrome dành cho iOS.
Tháng 5 năm 2022
Khả năng sử dụng bản dùng thử theo nguyên gốc sẽ tăng lên tới 50% người dùng từ Chrome 102 Beta.
Các API có trong bản dùng thử:
API | Ghi chú |
---|---|
Phân bổ Báo cáo | Nhà phát triển hướng dẫn dùng thử theo nguyên gốc. |
Protected Audience API | Nhà phát triển hướng dẫn dùng thử theo nguyên gốc. |
Chủ đề | Hướng dẫn cho nhà phát triển bản dùng thử theo nguyên gốc. Chủ đề đã bị vô hiệu hoá tạm thời trong bản dùng thử theo nguyên gốc do lỗi ảnh hưởng đến độ ổn định của trình duyệt. |
Có hàng rào Khung | Đã thêm Khung bảo vệ vào bản dùng thử theo nguyên gốc. Xem hướng dẫn về Protected Audience API để sử dụng trong 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 sử dụng Chrome 102 Beta.
Các API có trong bản dùng thử:
API | Ghi chú |
---|---|
Phân bổ Báo cáo | Ý định cá nhân vào bài đăng Thử nghiệm (I2E). Báo cáo phân bổ cũng có sẵn dưới dạng bản dùng thử theo nguyên gốc riêng lẻ. |
Protected Audience API | Ý định cá nhân vào bài đăng Thử nghiệm (I2E). Protected Audience API chỉ có trên máy tính với tập hợp con chức năng. |
Chủ đề | Ý định cá nhân vào bài đăng Thử nghiệm (I2E). |
Đă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 nguyê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 nguyên gốc đã chỉ định (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 nguyên gốc). Tìm hiểu thêm trong bài viết Làm quen với nguồn gốc của Chrome phiên bản thử nghiệm.
Mã thông báo bản dùng thử theo nguyên gốc sẽ được cấp ngay lập tức và bạn có thể thu hồi hoặc tạo lại mã đó 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ử theo nguyên gốc, bạn sẽ cần phải cung cấp mã thông báo thử nghiệm với HTML hoặc phản hồi của trang cụ thể đó.
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 đưa tiêu đề HTTP sau đây 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 iframe (chẳng hạn như
joinAdInterestGroup()
), thì bạn cần cung cấp mã thông báo 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 bạn đang sử dụng các tính năng dùng thử theo nguyên gốc thông qua JavaScript trên nhiều trang web, như bạn nhà cung cấp JavaScript của bên thứ ba có trong trang cấp cao nhất, thì bạn cần phải:
- Chọn lựa chọn So khớp bên thứ ba khi đăng ký nguồn gốc Google Cloud.
- 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 chứ không phải nội dung của chính bạn) khỏi 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 DevTools > Ứng dụng bảng điều khiển.
- Di chuyển xuống ngăn Khung.
- Chọn khung mà bạn muốn đặt mã thông báo. Ví dụ: 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 Bản dùng thử theo nguyên gốc.
- Bạn sẽ thấy một mục cho bản dùng thử
PrivacySandboxAdsAPIs
. - Mở rộng mục này để xem trạng thái của bản dùng thử theo nguyên gốc và mã thông báo.
Bản dùng thử theo nguyên gốc chỉ được cung cấp cho một nhóm nhỏ 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 TrialNotAllowed
màu đỏ
thông báo chống lạ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 thấy thông báo Success
màu xanh lục, thì tức là bản dùng thử theo nguyên gốc của bạn
cấu hình 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 nhau, hãy tham khảo bài viết Khắc phục sự cố liên quan đến nguồn gốc của Chrome bản dùng thử cho một danh sách kiểm tra chi tiết để xác thực cấu hình của bạn cho bản dùng thử theo nguyên gốc.
Phát hiện 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ó đang được báo cáo hay không trình duyệt trước khi sử dụng chú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 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 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 nhóm nhỏ người dùng Chrome. Họ cũng phải có chức năng có liên quan được bật trong phần cài đặt của họ để đủ đ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 có bản dùng thử theo nguyên gốc đang chạy.
- Xem phần Trạng thái dùng thử theo nguyên gốc để biết cấu hình hiện tại.
Nằm trong nhóm thử nghiệm đang hoạt động trên 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 bản dùng thử Hộp cát về quyền riêng tư thông qua 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 qua
chrome://settings/adPrivacy
. - bật cookie của bên thứ ba qua Cài đặt > Bảo mật và quyền riêng tư >
Cookie và các dữ liệu trang web khác đượ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 được qua
chrome://settings/cookies
. - ở trong phiên duyệt web chuẩn và không ở Chế độ ẩn danh.
Mặc dù bản dùng thử theo nguyên gốc sẽ chỉ hiển thị là đang hoạt động đối với 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ử so với phiên bản phát hành công khai của riêng bạn của bạn.
Kiểm soát việc bạn tham gia bản dùng thử theo nguyên gốc
Cơ chế của bản dùng thử theo nguyên gốc vẫn như cũ: bạn sẽ nhận được bản dùng thử theo nguyên gốc mã cho ngữ cảnh mà bạn muốn thử nghiệm với API. Với nhóm thử nghiệm mở rộng, bạn cần đả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 thử nghiệm phụ.
Sau đây là một phương pháp hiệu quả:
- Thêm mã thông báo bản dùng thử theo nguyên gốc theo mặc định trong mọi 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 cho yêu cầu này thử nghiệm), chọn xem có sử dụng hoặc không sử dụng chúng dựa trên thử nghiệm của riêng bạn tiêu chí. Ví dụ: nếu bạn đã có cơ sở hạ tầng của thử nghiệm A/B để thử nghiệm trên 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 nào mình sẽ tích cực sử dụng.
Bạn có thể ngăn hoàn toàn việc tham gia bản dùng thử theo nguyên gốc cho bất kỳ 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 có đáp ứng hạn mức thử nghiệm của riêng bạn hoặc cần giải quyết vấn đề trong thời gian dùng thử, sau đó không bao gồ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 đang 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 sử dụng bản dùng thử theo nguyên gốc cho một số khu vực. Bản dùng thử theo nguyên gốc hoạt động trên những trang có chứa mã thông báo, được bao gồm 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, bạn có thể viết mã để bao gồm mã thông báo dùng thử theo nguyên gốc dựa trên thông tin vị trí đó. Ví dụ: bạn có thể tìm cách 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 địa lý cụ thể có thể đặt Quyền
Chính sách để kiểm soát các tính năng
hữu dụng. Ví dụ: us.example.com
và uk.example.com
là
nguồn gốc địa lý cụ thể mà có thể kiểm soát được. Điều này không có nghĩa là
đã chọn không tham gia bản dùng thử theo nguyên gốc.
Với Chính sách về quyền, trang web sẽ thêm một đoạn mã nhỏ vào các trang cung cấp hướng dẫn cho trình duyệt. Khi trang tải, trình duyệt đọc hướng dẫn của Chính sách về 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 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 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 của bạn
Mã thông báo dùng thử theo nguyên gốc sẽ hết hạn sau 6 tuần kể từ ngày phát hành (hoặc vào cuối ngày nếu bạn cần làm việc này 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 trong cửa sổ đó cho việc sử dụng không gián đoạn các tính năng dùng thử 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 phiên 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 sẽ hết hạn, do đó, dịch vụ sẽ không bị gián đoạn đối với người dùng.
Kiểm thử cục bộ
Để biết hướng dẫn cụ thể về quy trình kiểm thử cho nhà phát triển tại địa phương, hãy xem:
Các API không được bật theo mặc định và phải được bật bằng cờ cho kiểm thử. Bạn cần đảm bảo rằng mình đã bật chế độ cài đặt cấu hình tương tự ở trên rồi:
- Sử dụng phiên bản và kênh Chrome mà tại đó các tính năng được cung cấp.
- Bật mọi API quyền riêng tư trong quảng cáo trong
chrome://settings/adPrivacy
.
Xem hướng dẫn cho nhà phát triển để biết phạm vi cung cấp của một số API và tính năng, cũng như cờ bổ sung để định cấu hình chi tiết hơn.