Chạy một Worklet Bộ nhớ dùng chung để chọn một URL và kết xuất URL đó trong một khung bảo vệ.
API Bộ nhớ dùng chung là một Quyền riêng tư Đề xuất hộp cát cho mục đích chung, lưu trữ trên nhiều trang web, hỗ trợ nhiều các trường hợp sử dụng có thể xảy ra. Một ví dụ là kiểm soát tần suất, có sẵn cho thử nghiệm trong Chrome Beta 104.0.5086.0 trở lên.
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 đã lưu trữ rồi hiển thị URL đó trong một khung bảo vệ. Bạn có thể dùng công cụ này để chọn quảng cáo mới hoặc nội dung khác khi đã đạt đến giới hạn tần suất.
Thử nghiệm lựa chọn mẫu quảng cáo theo tần suất
Để kiểm tra lựa chọn mẫu quảng cáo theo tần suất với Bộ nhớ dùng chung và Khung bảo vệ, hãy xác nhận rằng bạn
sử dụng Chrome 104.0.5086.0 trở lên. Bật mọi 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 mã mẫu
Để chọn và tạo một URL mờ, hãy đăng ký mô-đun worklet để đọc nội dung được chia sẻ dữ liệu lưu trữ. Lớp worklet nhận danh sách tối đa 8 URL, sau đó sẽ trả về chỉ mục của URL đã chọn.
Khi ứng dụng gọi sharedStorage.selectURL()
, worklet
thực thi và trả về một URL mờ để kết xuất vào khung bảo vệ.
Giả sử bạn muốn chọn một quảng cáo hoặc nội dung khác để hiển thị dựa trên tần suất người dùng đã nhìn thấy quảng cáo hoặc nội dung đó trước đó. Bạn có thể đếm số lần một người dùng đã xem một nội dung và lưu trữ giá trị đó vào bộ nhớ dùng chung. Sau khi được lưu trữ, bạn có thể sử dụng giá trị trong bộ nhớ dùng chung trên nhiều nguồn gốc.
Sau đó, worklet bộ nhớ dùng chung sẽ đọc các giá trị trong bộ nhớ dùng chung và tăng bộ đếm theo mỗi chế độ xem bổ sung. Nếu số lượng chưa đạt đến giới hạn xác định trước, nội dung bạn muốn kết xuất sẽ được trả về (chỉ mục 1
). Nếu không, URL mặc định sẽ được trả về (chỉ mục 0
).
Trong ví dụ này:
creative-selection-by-frequencyjs
được tải thông qua iframe của nhà sản xuất nội dung hoặc nhà quảng cáo, đồng thời chịu trách nhiệm để tải worklet bộ nhớ dùng chung và kết xuất hình ảnh mờ được trả về nguồn vào một khung bảo vệ.creative-selection-by-frequency-worklet.js
là worklet bộ nhớ dùng chung có chức năng đọc để xác định URL nào được trả về cho một nội dung hoặc một quảng cáo.
creative-selection-by-frequency.js
// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
{ url: `https://${contentProducerUrl}/default-content.html` },
{ url: `https://${contentProducerUrl}/example-content.html` },
];
async function injectAd() {
// Load the worklet module.
await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');
// Set the initial frequency count
window.sharedStorage.set('frequency-count', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose an ad based on the frequency count in shared storage.
const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectAd();
creative-selection-by-frequency-worklet.js
const FREQUENCY_LIMIT = 5;
class CreativeSelectionByFrequencyOperation {
async run(urls, data) {
// Read the current frequency limit in shared storage
const count = parseInt(await sharedStorage.get('frequency-count'));
// Check if the frequency limit has been reached.
if (count === FREQUENCY_LIMIT) {
console.log('Frequency limit has been reached, and the default content will be rendered.');
return 0;
}
// Set the new frequency count in shared storage
await sharedStorage.set('frequency-count', count + 1);
return 1;
}
}
// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);
Trường hợp sử dụng
Đây chỉ là một số trường hợp sử dụng có thể áp dụng cho Bộ nhớ dùng chung. Chúng tôi sẽ Hãy tiếp tục thêm các ví dụ dưới dạng nhận phản hồi và khám phá các trường hợp sử dụng mới.
Lựa chọn nội dung
Chọn và hiển thị nội dung khác nhau trên các trang web trong khung bảo vệ dựa trên thông tin được thu thập trong Bộ nhớ dùng chung. Cổng đầu ra cho các trường hợp sử dụng này là lựa chọn URL.
- Xoay vòng mẫu quảng cáo: 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 người dùng mẫu quảng cáo nào xem trên các trang web khác nhau.
- 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.
- Trải nghiệm người dùng tuỳ chỉnh: 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
Tạo báo cáo tóm tắt
Thu thập thông tin bằng Bộ nhớ dùng chung và tạo một báo cáo tóm tắt tổng hợp, gây phiền toái. Cổng đầu ra cho các trường hợp sử dụng này là 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 muốn biết có bao nhiêu người đã xem nội dung của họ. Sử dụng Bộ nhớ dùng chung để ghi lại lần đầu người dùng nhìn thấy quảng cáo, video được nhúng hoặc ấn phẩm của bạn và ngăn chặn nội dung sao chép tính toán cùng một người dùng đó trên các trang web khác nhau. Sau đó, bạn có thể sử dụng API Tổng hợp riêng tư để xuất báo cáo tóm tắt về phạm vi tiếp cận của mình.
- Đo lường thông tin nhân khẩu học: 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 độc 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 người dùng trong một ngữ cảnh nơi bạn có (chẳng hạn như trang web của bên thứ nhất) và sử dụng để báo cáo về nội dung đó trên nhiều trang web khác, chẳng hạn như nội dung được nhúng.
- Đo lường tần suất trên K+: Đôi khi được mô tả là "tần suất hiệu quả", thường có số lượng 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 nằm 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 người dùng riêng biệt đã xem một nội dung ít nhất K lần.
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ư.