Izinkan akses tulis penyimpanan lintas situs tanpa batas dengan akses baca yang menjaga privasi.
Status penerapan
Dokumen ini menguraikan proposal untuk penyimpanan lintas situs yang tidak dipartisi: Shared Storage API.
- Shared Storage API sekarang telah dipindahkan ke ketersediaan umum.
- Demo langsung tersedia, begitu juga pengujian:
- Gerbang output pemilihan URL tersedia untuk pengujian lokal dari Chrome M105 dan yang lebih baru.
- Output Agregasi Pribadi tersedia untuk pengujian lokal dari Chrome M107+.
- Pengukuran dengan Private Agregasi API kini tersedia secara umum.
- Status platform Chrome
| Proposal | Status |
|---|---|
Pelaporan tingkat peristiwa untuk Pilihan Konten (selectURL()) |
Tersedia hingga setidaknya tahun 2026 |
| Anggaran per lokasi Penjelasan |
Tersedia di M119 |
| Izinkan penulisan dari header respons Penjelasan Masalah GitHub |
Tersedia di M124. Dapat diaktifkan secara manual di M119-M123 |
| Waktu tunggu kontribusi Agregasi Pribadi Penjelasan |
Tersedia di M119 |
| Men-debug worklet Shared Storage dengan DevTools Bagian |
Tersedia di M120 |
| Memperbarui batas penyimpanan data Shared Storage menjadi 5 MB Penjelasan |
Tersedia di M124 |
Mengapa kita memerlukan API ini?
Untuk mencegah pelacakan pengguna lintas situs, browser mempartisi semua bentuk penyimpanan (cookie, localStorage, cache, dll.). Namun, ada sejumlah kasus penggunaan sah yang mengandalkan penyimpanan tidak dipartisi yang tidak mungkin dilakukan tanpa bantuan dari API web baru. Misalnya, pembuat konten mungkin ingin mengukur jangkauan di berbagai situs, tanpa mengandalkan ID lintas situs.
Shared Storage API memungkinkan situs menyimpan dan mengakses data lintas situs yang tidak dipartisi. Data ini harus dibaca di lingkungan yang aman untuk mencegah kebocoran.
Anda dapat menggunakan data Penyimpanan Bersama dengan dua cara:
- Pemilihan konten lintas situs.
- Agregasi data lintas situs yang berlebihan dengan Private Aggregation API
Untuk siapa ini?
Ada banyak jenis perusahaan yang dapat memperoleh manfaat dari penggunaan Shared Storage API. Contoh:
- Teknologi iklan dapat mengukur jangkauan kampanye, menetapkan batas frekuensi, dan merotasi materi iklan, yang saat ini mengandalkan cookie pihak ketiga.
- Penyedia pembayaran dapat menentukan apakah pengguna adalah pelanggan lama dan menyesuaikan pengalaman checkout.
- Perusahaan keamanan web dapat membuat logika khusus untuk menandai perilaku yang mencurigakan atau berbahaya.
Apakah perusahaan Anda mencari solusi penyimpanan lintas lokasi yang belum ditangani? Bagikan kasus penggunaan Anda.
Kasus penggunaan
Shared Storage API bermaksud mendukung banyak kasus penggunaan, menggantikan beberapa penggunaan yang ada untuk cookie pihak ketiga. Hal ini mencakup:
| Kasus penggunaan | Deskripsi | Gate output |
|---|---|---|
| Merotasi materi iklan | Anda dapat menyimpan data, seperti ID materi iklan, jumlah penayangan, dan interaksi pengguna, untuk menentukan materi iklan yang dilihat pengguna di berbagai situs. Dengan begitu, Anda dapat menyeimbangkan penayangan dan menghindari kejenuhan konten tertentu, yang dapat membantu Anda menghindari pengalaman pengguna yang negatif. | Pilihan URL |
| Menjalankan pengujian A/B | Anda dapat menetapkan pengguna ke grup eksperimen, lalu menyimpan grup tersebut di penyimpanan bersama untuk diakses lintas situs. | Pilihan URL |
| Menyesuaikan pengalaman pengguna untuk pelanggan yang dikenal | Anda dapat membagikan konten kustom dan pesan ajakan (CTA) berdasarkan status pendaftaran pengguna atau status pengguna lainnya. | Pilihan URL |
| Mitigasi anti-penyalahgunaan | Organisasi anti-penyalahgunaan, antipenipuan, dan keamanan web sering kali menggunakan teknik eksklusif untuk mendeteksi pengguna yang berbahaya, baik bot otomatis atau manusia sungguhan yang mencoba melukai pengguna. Anda dapat menguji berbagai strategi di sini, baik menggunakan gate output Selection URL untuk mengenkode rating kepercayaan pengguna atau menggunakan gate output Agregasi Pribadi untuk membuat set data agar dapat mendeteksi anomali. | Pemilihan URL, Private Aggregation API |
| Mengukur jangkauan unik | Banyak produser dan pengiklan konten sering kali ingin mengetahui jumlah pengguna unik yang melihat konten mereka. Anda dapat menggunakan Penyimpanan Bersama untuk melaporkan saat pertama kali pengguna melihat iklan Anda, video tersemat, publikasi, dan mencegah penghitungan duplikat dari pengguna yang sama tersebut di situs yang berbeda, sehingga memberikan laporan berisi data gabungan mengenai perkiraan jangkauan unik Anda. | Private Aggregation API |
| Mengukur demografi pengguna | Produser konten sering kali ingin memahami demografi audiensnya. Anda dapat menggunakan penyimpanan bersama untuk mencatat data demografi pengguna dalam konteks tempat data tersebut dimiliki, seperti situs pihak pertama, dan menggunakan pelaporan gabungan untuk melaporkannya di banyak situs lain, seperti konten yang disematkan. | Private Aggregation API |
| Mengukur jangkauan frekuensi K+ | Terkadang dijelaskan sebagai "frekuensi yang efektif", sering kali terdapat jumlah minimum penayangan sebelum pengguna mengenali atau mengingat konten tertentu (sering kali dalam konteks penayangan iklan). Anda dapat menggunakan Penyimpanan Bersama untuk membuat laporan tentang pengguna unik yang telah melihat konten minimal K kali. | Private Aggregation API |
Proposal ini bermaksud untuk membuat API tujuan umum yang mendukung banyak kemungkinan kasus penggunaan di masa mendatang. Hal ini memungkinkan eksperimen dan perubahan lebih lanjut, untuk berkembang bersama ekosistem web.
Bagaimana cara kerja Penyimpanan Bersama?
Dengan Penyimpanan Bersama, Anda dapat membuat keputusan yang tepat berdasarkan data lintas situs, tanpa membagikan informasi pengguna (seperti histori browser atau detail pribadi lainnya) dengan situs penyematan atau memindahkan data ke server Anda sendiri.
Anda bisa menulis ke penyimpanan bersama kapan saja, seperti API penyimpanan JavaScript lainnya seperti localStorage atau indexedDB. Tidak seperti API penyimpanan lainnya, Anda hanya dapat membaca nilai penyimpanan bersama di lingkungan yang aman, yang dikenal sebagai worklet penyimpanan bersama.
Worklet adalah tempat Anda menambahkan logika bisnis. Di dalam worklet, Anda diizinkan untuk membaca dan memproses nilai dari Shared Storage, tetapi Anda tidak dapat langsung menampilkan nilai yang tepat ke pemanggil worklet. Untuk mengekstrak informasi yang berguna dari worklet, tersedia kumpulan "gate". Ada dua gate yang tersedia, tetapi akan ditambahkan beberapa gate di masa mendatang.
Gate output Shared Storage API yang tersedia adalah:
- Pemilihan URL lintas situs: Anda dapat menjalankan skrip worklet untuk memilih URL dari daftar yang disediakan, berdasarkan data yang disimpan, lalu merender konten tersebut dalam frame dengan fence.
- Agregasi yang bising dengan Private Aggregation API: Anda dapat menjalankan worklet untuk mengirim data lintas situs melalui Private Aggregation API dan menampilkan laporan ringkasan.
Mencoba Shared Storage API
Shared Storage API untuk gate output pemilihan URL dan gate output Agregasi Pribadi tersedia untuk pengujian. Pemilihan konten dapat diuji di Chrome
Canary/Dev/Beta M105+ dan Private Aggregation API tersedia untuk diuji di
Chrome M107+ Canary dan Dev. API ini dapat diuji dengan mengaktifkan tanda
Eksperimen API Iklan Privacy Sandbox di chrome://flags/#privacy-sandbox-ads-apis.
Menggunakan demo
Demo tersedia, dan Anda dapat meninjau kode di GitHub.
Demo ini dibuat dari perspektif pengiklan, teknologi iklan, distributor konten, atau layanan pihak ketiga lainnya yang ingin menyimpan informasi di berbagai situs penayang. Dalam demo ini, kode pihak ketiga yang sama akan berjalan di situs Publisher A dan Publisher B untuk setiap kasus penggunaan. Kunjungi halaman penayang untuk melihat cara data dibagikan dalam konteks lintas situs.
Demo ini berisi kasus penggunaan untuk pemilihan konten dan Agregasi Pribadi.
Untuk demo pemilihan konten, tersedia kasus penggunaan Rotasi materi iklan, Menyesuaikan pengalaman penggunaan untuk pelanggan dikenal, dan Jalankan pengujian A/B.
Untuk demo Agregasi Pribadi, Anda dapat melihat pratinjau Mengukur jangkauan unik, Mengukur jangkauan frekuensi K+ yang unik. Mengukur demografi pengguna, dan
Men-debug worklet Shared Storage dengan DevTools
Untuk memeriksa worklet Shared Storage yang dimulai dari laman yang sedang Anda buka, Anda bisa mengunjungi tab "Sources" di panel DevTools, dan menambahkan titik henti sementara pemroses peristiwa "Shared Storage Worklet / Script First Statement". Titik henti sementara ini akan menjeda eksekusi skrip modul awal atau worklet yang berumur singkat saat dimulai.
Selain itu, halaman chrome://inspect/#shared-storage-worklets menampilkan semua worklet Penyimpanan Bersama yang aktif dari semua halaman.
Berinteraksi dan berbagi masukan
Proposal Penyimpanan Bersama sedang dalam diskusi aktif dan dapat berubah pada masa mendatang. Jika Anda mencoba API ini dan memiliki masukan, sampaikanlah kepada kami.
- GitHub: Baca proposal, ajukan pertanyaan, dan berpartisipasilah dalam diskusi.
- Pengumuman Shared Storage API: Bergabunglah atau lihat pengumuman sebelumnya di milis kami
- Dukungan developer: Ajukan pertanyaan dan ikuti diskusi di repo Dukungan Developer Privacy Sandbox.