Nhiều nhà sản xuất nội dung và nhà quảng cáo muốn biết có bao nhiêu người dùng riêng biệt đã xem nội dung của họ. Sử dụng Bộ nhớ dùng chung để ghi lại lần đầu tiên người dùng xem quảng cáo, video được nhúng hoặc ấn phẩm của bạn, đồng thời ngăn việc tính trùng lặp cho cùng một người dùng trên nhiều trang web. Sau đó, bạn có thể sử dụng Private Aggregation API để xuất báo cáo tóm tắt về phạm vi tiếp cận.
Shared Storage API là một đề xuất Hộp cát về quyền riêng tư cho bộ nhớ đa dụng, trên nhiều trang web, hỗ trợ nhiều trường hợp sử dụng có thể có. Private Aggregation API là một đầu ra có trong Shared Storage, cho phép bạn tổng hợp dữ liệu trên nhiều trang web. Để tìm hiểu thêm về các phương thức triển khai những phương pháp đo lường này, hãy xem sách trắng về phạm vi tiếp cận của chúng tôi.
Thử đo lường phạm vi tiếp cận người dùng riêng biệt
Để thử nghiệm tính năng đo lường phạm vi tiếp cận người dùng riêng biệt bằng Shared Storage và Private Aggregation, hãy xác nhận rằng bạn đang sử dụng Chrome M107 trở lên. Bật tất cả API Quyền riêng tư trong quảng cáo trong chrome://settings/adPrivacy
.
Bạn cũng có thể bật Bộ nhớ dùng chung bằng cờ --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
trong dòng lệnh.
Thử nghiệm với mã mẫu
Bạn có thể muốn theo dõi số người dùng riêng biệt đã xem nội dung của bạn trên nhiều trang web. Trong ví dụ này, phương diện mã nội dung được mã hoá thành khoá tổng hợp (vùng chứa) và số lượng được dùng làm giá trị tổng hợp. Báo cáo tóm tắt sẽ chứa thông tin như "Khoảng 391 người dùng đã xem mã nội dung 123".
Trong ví dụ này:
unique-reach-measurement.js
được tải bằng khung và chịu trách nhiệm tải công cụ lưu trữ dùng chung.unique-reach-measurement-worklet.js
là công cụ lưu trữ dùng chung giúp kiểm tra cờ trong bộ nhớ dùng chung và gửi báo cáo bằng Private Aggregation API.
async function measureUniqueReach() {
// Load the Shared Storage worklet
await window.sharedStorage.worklet.addModule('reach-measurement-worklet.js');
// Run the reach measurement operation
await window.sharedStorage.run('reach-measurement', { data: { contentId: '1234' } });
}
measureUniqueReach();
// Learn more about noise and scaling from the Private Aggregation fundamentals
// documentation on Chrome blog
const SCALE_FACTOR = 65536;
function convertContentIdToBucket(contentId) {
return BigInt(contentId);
}
class ReachMeasurementOperation {
async run(data) {
const { contentId } = data;
// Read from Shared Storage
const key = 'has-reported-content';
const hasReportedContent = (await sharedStorage.get(key)) === 'true';
// Don't report if a report has been sent already
if (hasReportedContent) {
return;
}
// Generate the aggregation key and the aggregatable value
const bucket = convertContentIdToBucket(contentId);
const value = 1 * SCALE_FACTOR;
// Send an aggregatable report using the Private Aggregation API
privateAggregation.contributeToHistogram({ bucket, value });
// Set the report submission status flag
await sharedStorage.set(key, true);
}
}
// Register the operation
register('reach-measurement', ReachMeasurementOperation);
Tương tác và chia sẻ ý kiến phản hồi
Xin lưu ý rằng đề xuất về API Bộ nhớ dùng chung đang được thảo luận và phát triển tích cực, do đó có thể thay đổi.
Chúng tôi rất mong được nghe ý kiến của bạn về Shared Storage API.
- Đề xuất: Xem lại đề xuất chi tiết.
- Thảo luận: Tham gia cuộc thảo luận đang diễn ra để đặt câu hỏi và chia sẻ thông tin chi tiết của bạn.
Luôn nắm thông tin mới nhất
- Danh sách gửi thư: Đăng ký nhận danh sách gửi thư của chúng tôi để biết thông tin cập nhật và thông báo mới nhất liên quan đến Shared Storage API.
Bạn cần được trợ giúp?
- Hỗ trợ nhà phát triển: Kết nối với các nhà phát triển khác và nhận câu trả lời cho thắc mắc của bạn trong Kho lưu trữ hỗ trợ nhà phát triển Hộp cát về quyền riêng tư.