Cho phép ghi dữ liệu vào bộ nhớ trên nhiều trang web không giới hạn cùng với quyền đọc dữ liệu bảo đảm quyền riêng tư.
Trạng thái triển khai
Tài liệu này trình bày đề xuất về việc sử dụng bộ nhớ không phân vùng, trên nhiều trang web: API Bộ nhớ dùng chung.
- API Bộ nhớ dùng chung hiện đã chuyển sang giai đoạn phát hành rộng rãi.
- Có bản minh hoạ trực tiếp dưới dạng bản kiểm thử:
- Bạn có thể sử dụng cổng đầu ra để lựa chọn URL trên Chrome M105 trở lên để thử nghiệm cục bộ.
- Bạn có thể sử dụng cổng đầu ra Tổng hợp riêng tư trên Chrome M107 trở lên để kiểm thử cục bộ.
- Tính năng đo lường bằng API tổng hợp riêng tư hiện đã được phát hành rộng rãi.
- Trạng thái của nền tảng Chrome
Proposal | Status |
---|---|
Event-level reporting for Content Selection (selectURL() ) |
Available until at least 2026 |
Per-site budgeting Explainer |
Available in M119 |
Allow writing from response headers Explainer GitHub Issue |
Available in M124. Can be manually enabled in M119-M123 |
Private Aggregation contribution timeout Explainer |
Available in M119 |
Debugging Shared Storage worklets with DevTools Section |
Available in M120 |
Update Shared Storage data storage limit to 5MB Explainer |
Available in M124 |
Tại sao chúng ta cần API này?
Để ngăn chặn hoạt động theo dõi người dùng trên nhiều trang web, các trình duyệt phân vùng tất cả các dạng bộ nhớ (cookie, localStorage, bộ nhớ đệm, v.v.). Tuy nhiên, có một số lượng trường hợp sử dụng hợp pháp phụ thuộc vào bộ nhớ không được phân vùng. không thể nếu không có sự trợ giúp của các API web mới. Ví dụ: trình sản xuất nội dung có thể muốn đo lường phạm vi tiếp cận trên nhiều trang web mà không dựa vào giá trị nhận dạng trên nhiều trang web.
Shared Storage API cho phép các trang web lưu trữ và truy cập không được phân vùng dữ liệu trên nhiều trang web. Dữ liệu này phải được đọc trong một môi trường an toàn để tránh rò rỉ.
Bạn có thể sử dụng dữ liệu của Bộ nhớ dùng chung theo hai cách:
- Lựa chọn nội dung trên nhiều trang web.
- Tổng hợp dữ liệu nhiễu trên nhiều trang web bằng API tổng hợp riêng tư
Đối tượng sử dụng
Có nhiều loại công ty có thể hưởng lợi từ việc sử dụng API Bộ nhớ dùng chung. Ví dụ:
- Các công nghệ quảng cáo có thể đo lường phạm vi tiếp cận của chiến dịch, đặt giới hạn tần suất và xoay vòng mẫu quảng cáo – tất cả đều dựa vào cookie của bên thứ ba.
- Nhà cung cấp dịch vụ thanh toán có thể xác định xem người dùng có phải là khách hàng hiện tại hay không và điều chỉnh trải nghiệm thanh toán.
- Các công ty bảo mật web có thể xây dựng logic tuỳ chỉnh để gắn cờ hành vi đáng ngờ hoặc nguy hiểm.
Có phải công ty của bạn chưa tìm kiếm giải pháp lưu trữ trên nhiều trang web địa chỉ của bạn không? Chia sẻ trường hợp sử dụng của bạn.
Trường hợp sử dụng
API Bộ nhớ dùng chung hướng đến hỗ trợ nhiều trường hợp sử dụng, thay thế một vài cách sử dụng hiện tại đối với cookie của bên thứ ba. Nội dung như vậy bao gồm:
Trường hợp sử dụng | Mô tả | Cổng đầu ra |
---|---|---|
Xoay vòng mẫu quảng cáo | Bạn có thể lưu trữ dữ liệu, chẳng hạn như mã mẫu quảng cáo, số lượt xem và tương tác của người dùng để xác định xem mẫu quảng cáo nào của người dùng xem trên các trang web khác nhau. Điều này cho phép bạn cân bằng giữa số lượt xem và tránh gây quá mức cho một số nội dung, nhờ đó giúp bạn tránh trải nghiệm người dùng tiêu cực. | Lựa chọn URL |
Chạy thử nghiệm A/B | Bạn có thể chỉ định người dùng vào một nhóm thử nghiệm, sau đó lưu trữ nhóm đó trong bộ nhớ dùng chung để có thể truy cập trên nhiều trang web. | Lựa chọn URL |
Tuỳ chỉnh trải nghiệm người dùng cho những khách hàng đã biết | Bạn có thể chia sẻ nội dung tuỳ chỉnh và lời kêu gọi hành động dựa trên trạng thái đăng ký của người dùng hoặc các trạng thái khác của người dùng. | Lựa chọn URL |
Các biện pháp giảm thiểu hành vi sai trái | Các tổ chức chống hành vi sai trái, chống lừa đảo và bảo mật web thường dùng những kỹ thuật thuộc quyền sở hữu riêng để phát hiện người dùng độc hại, cho dù đó là bot tự động hay người thật đang cố gắng gây hại. Bạn có thể thử nghiệm nhiều chiến lược tại đây, cho dù đó là sử dụng cổng đầu ra Lựa chọn URL để mã hoá điểm xếp hạng độ tin cậy của người dùng hay sử dụng cổng đầu ra của tính năng Tổng hợp riêng tư để tạo tập dữ liệu nhằm phát hiện hoạt động bất thường. | Lựa chọn URL, API tổng hợp riêng tư |
Đo lường phạm vi tiếp cận người dùng riêng biệt | Nhiều nhà sản xuất nội dung và nhà quảng cáo thường muốn biết có bao nhiêu người riêng biệt đã xem nội dung của họ. Bạn có thể sử dụng Bộ nhớ dùng chung để báo cáo về lần đầu tiên người dùng nhìn thấy quảng cáo, video được nhúng, ấn phẩm của bạn, đồng thời tránh việc tính trùng lặp người dùng đó trên một trang web khác. Nhờ đó, bạn sẽ có báo cáo tổng hợp về phạm vi tiếp cận người dùng riêng biệt gần đúng của mình. | Private Aggregation API |
Đo lường thông tin nhân khẩu học của người dùng | Các nhà sản xuất nội dung thường muốn hiểu rõ đặc điểm nhân khẩu học của khán giả. Bạn có thể sử dụng bộ nhớ dùng chung để ghi lại dữ liệu nhân khẩu học của người dùng trong bối cảnh bạn có dữ liệu đó, chẳng hạn như trang web của bên thứ nhất, đồng thời sử dụng báo cáo tổng hợp để báo cáo về dữ liệu đó trên nhiều trang web khác, chẳng hạn như nội dung được nhúng. | Private Aggregation API |
Đo lường phạm vi tiếp cận tần suất K+ | Đôi khi được mô tả là "tần suất hiệu quả", thường có số lượt xem tối thiểu trước khi người dùng nhận ra hoặc nhớ lại nội dung nhất định (thường là trong ngữ cảnh của lượt xem quảng cáo). Bạn có thể sử dụng Bộ nhớ dùng chung để tạo báo cáo về những người dùng riêng biệt đã xem một nội dung ít nhất K lần. | Private Aggregation API |
Đề xuất này nhằm mục đích tạo ra một API mục đích chung hỗ trợ nhiều các trường hợp sử dụng có thể xảy ra trong tương lai. Điều này cho phép bạn thử nghiệm và thay đổi thêm, phát triển cùng với hệ sinh thái web.
Bộ nhớ dùng chung hoạt động như thế nào?
Bộ nhớ dùng chung giúp bạn đưa ra quyết định sáng suốt dựa trên dữ liệu trên nhiều trang web, mà không chia sẻ thông tin người dùng (chẳng hạn như lịch sử trình duyệt hoặc thông tin cá nhân khác chi tiết) bằng trang web nhúng hoặc đánh cắp dữ liệu sang máy chủ của riêng bạn.
Bạn có thể ghi vào bộ nhớ dùng chung bất cứ lúc nào, chẳng hạn như các API lưu trữ JavaScript khác, chẳng hạn như localStorage hoặc chỉ mụcDB. Không giống như các API lưu trữ khác, bạn chỉ có thể đọc các giá trị của bộ nhớ dùng chung trong một môi trường an toàn, còn gọi là worklet bộ nhớ dùng chung.
Worklet là nơi bạn thêm logic nghiệp vụ. Bên trong worklet, bạn được phép đọc và xử lý giá trị từ Bộ nhớ dùng chung, nhưng bạn không thể trực tiếp trả về giá trị chính xác cho phương thức gọi worklet. Để trích xuất thông tin hữu ích thông tin từ worklet, một tập hợp các "cổng" có sẵn. Có hai có cổng, nhưng trong tương lai sẽ có thêm nhiều cổng khác.
Các cổng đầu ra hiện có của Shared Storage API:
- Lựa chọn URL trên nhiều trang web: Bạn có thể chạy tập lệnh worklet để chọn một URL trong danh sách được cung cấp, dựa trên dữ liệu được lưu trữ, sau đó hiển thị nội dung đó trong khung bảo vệ.
- Tổng hợp nhiễu bằng API tổng hợp riêng tư: Bạn có thể chạy một worklet để gửi dữ liệu trên nhiều trang web thông qua API tổng hợp riêng tư và trả về một báo cáo tóm tắt.
Dùng thử API Bộ nhớ dùng chung
API Bộ nhớ dùng chung cho cổng đầu ra lựa chọn URL và đầu ra Tổng hợp riêng tư
đều có sẵn để thử nghiệm. Bạn có thể kiểm tra khả năng lựa chọn nội dung trong Chrome
Canary/Dev/Beta M105+ và API tổng hợp riêng tư hiện có thể kiểm thử trong
Chrome M107+ Canary và Dev. Bạn có thể kiểm tra API này bằng cách bật tất cả các API quyền riêng tư trong quảng cáo trong chrome://settings/adPrivacy
.
Sử dụng bản minh hoạ
Có bản minh hoạ và bạn có thể xem mã trên GitHub.
Bản minh hoạ này được xây dựng từ góc nhìn của một nhà quảng cáo, công nghệ quảng cáo nhà phân phối nội dung hoặc dịch vụ khác của bên thứ ba muốn lưu trữ của các nhà xuất bản khác nhau của bạn. Trong bản minh hoạ, cùng một thứ ba mã của bên đó sẽ chạy trên cả trang web Nhà xuất bản A và Nhà xuất bản B cho từng trường hợp sử dụng. Truy cập các trang của nhà xuất bản để xem cách dữ liệu được chia sẻ trong ngữ cảnh trên nhiều trang web.
Bản minh hoạ chứa các trường hợp sử dụng tính năng lựa chọn nội dung và tính năng Tổng hợp riêng tư.
Đối với phần minh hoạ cách lựa chọn nội dung, Xoay vòng mẫu quảng cáo, Tuỳ chỉnh trải nghiệm sử dụng cho khách hàng đã biết, và Bạn có thể sử dụng các trường hợp sử dụng Chạy thử nghiệm A/B.
Đối với bản minh hoạ về tính năng Tổng hợp riêng tư, bạn có thể xem trước Đo lường phạm vi tiếp cận người dùng riêng biệt Đo lường phạm vi tiếp cận tần suất K+ và Đo lường thông tin nhân khẩu học của người dùng.
Gỡ lỗi Worklet Bộ nhớ dùng chung bằng Công cụ cho nhà phát triển
Để kiểm tra các công việc của Bộ nhớ dùng chung bắt đầu từ trang bạn đang truy cập, bạn có thể truy cập phần "Nguồn" trong bảng điều khiển Công cụ cho nhà phát triển rồi thêm "WorkManager bộ nhớ dùng chung / Câu lệnh đầu tiên của tập lệnh" điểm ngắt trình nghe sự kiện. Điểm ngắt này sẽ tạm dừng việc thực thi tập lệnh của mô-đun ban đầu hoặc các worklet ngắn hạn khi khởi động.
![Gỡ lỗi worklet Bộ nhớ dùng chung bằng cách thêm trình nghe ở cấp sự kiện.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/shared-storage-devtools-debugging.png?authuser=1&hl=vi)
Ngoài ra, trang chrome://inspect/#shared-storage-worklets
cho thấy tất cả Worklet Bộ nhớ dùng chung đang hoạt động trên mọi trang.
Thu hút và chia sẻ ý kiến phản hồi
Đề xuất về Bộ nhớ dùng chung đang được thảo luận và có thể thay đổi trong tương lai. Nếu bạn dùng thử API này và có ý kiến phản hồi, chúng tôi rất mong nhận được ý kiến phản hồi của bạn.
- GitHub: Đọc đề xuất, tiếp cận sách trắng, đặt câu hỏi và tham gia thảo luận.
- Thông báo về API Bộ nhớ dùng chung: Tham gia hoặc xem các thông báo trước đây trong danh sách gửi thư của chúng tôi
- Hỗ trợ nhà phát triển: Đặt câu hỏi và tham gia thảo luận trên Kho lưu trữ hỗ trợ nhà phát triển Hộp cát về quyền riêng tư.