Ringkasan Penyimpanan Bersama

Izinkan akses tulis penyimpanan lintas situs tanpa batas dengan akses baca yang menjaga privasi.

Status penerapan

Dokumen ini menguraikan proposal untuk penyimpanan lintas situs tanpa partisi: Shared Storage API.

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 API web baru. Misalnya, produsen 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:

Ditujukan untuk siapa ini?

Ada banyak jenis perusahaan yang mungkin mendapatkan manfaat dari penggunaan Shared Storage API. Contoh:

  • Teknologi iklan dapat mengukur jangkauan kampanye, menetapkan batas frekuensi, dan merotasi materi iklan, yang semuanya saat ini mengandalkan cookie pihak ketiga.
  • Penyedia pembayaran dapat menentukan apakah pengguna sudah menjadi pelanggan lama dan menyesuaikan pengalaman checkout.
  • Perusahaan keamanan web dapat membuat logika kustom untuk menandai perilaku yang mencurigakan atau berbahaya.

Apakah perusahaan Anda mencari solusi penyimpanan lintas situs yang belum ditangani? Bagikan kasus penggunaan Anda.

Kasus penggunaan

Shared Storage API ditujukan untuk 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 mana yang dilihat pengguna di berbagai situs. Hal ini memungkinkan Anda menyeimbangkan tampilan dan menghindari saturasi konten tertentu, yang dapat membantu Anda menghindari pengalaman pengguna yang negatif. Pemilihan URL
Menjalankan pengujian A/B Anda dapat menetapkan pengguna ke grup eksperimen, lalu menyimpan grup tersebut di penyimpanan bersama untuk diakses lintas situs. Pemilihan URL
Menyesuaikan pengalaman pengguna untuk pelanggan yang dikenal Anda dapat membagikan konten kustom dan pesan ajakan (CTA) berdasarkan status pendaftaran pengguna atau status pengguna lain. Pemilihan URL
Mitigasi anti-penyalahgunaan Organisasi anti-penyalahgunaan, anti-penipuan, dan keamanan web sering menggunakan teknik eksklusif untuk mendeteksi pengguna berbahaya, baik bot otomatis atau manusia sungguhan yang mencoba menyebabkan bahaya. Anda dapat menguji berbagai strategi di sini, baik menggunakan gate output Pemilihan URL untuk mengenkode rating kepercayaan pengguna atau menggunakan gate output Agregasi Pribadi untuk membuat set data untuk deteksi anomali. Pemilihan URL, Private Aggregation API
Mengukur jangkauan unik Banyak produser dan pengiklan konten yang 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 yang disematkan, publikasi, dan mencegah penghitungan duplikat pengguna yang sama tersebut di situs lain, yang memberi Anda laporan derau gabungan tentang 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 demografis pengguna dalam konteks tempat data tersebut tersedia, seperti situs pihak pertama Anda, 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 ada jumlah penayangan minimum sebelum pengguna akan mengenali atau mengingat kembali konten tertentu (sering kali dalam konteks penayangan iklan). Anda dapat menggunakan Penyimpanan Bersama untuk membuat laporan pengguna unik yang telah melihat sebuah konten setidaknya K kali. Private Aggregation API

Proposal ini dimaksudkan untuk membuat API tujuan umum yang mendukung banyak kemungkinan kasus penggunaan di masa mendatang. Hal ini memungkinkan eksperimen dan perubahan lebih lanjut, untuk tumbuh bersama ekosistem web.

Bagaimana cara kerja Penyimpanan Bersama?

Dengan Penyimpanan Bersama, Anda dapat membuat keputusan yang tepat berdasarkan data lintas situs, tanpa perlu membagikan informasi pengguna (seperti histori browser atau detail pribadi lainnya) dengan situs penyematan atau memindahkan data secara tidak sah ke server Anda sendiri.

Anda dapat 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, sekumpulan "gate" tersedia. Ada dua gate yang tersedia, tetapi mungkin akan ditambahkan di masa mendatang.

Gateway 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 tersimpan, 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 pengujian di Chrome M107+ Canary dan Dev. API ini dapat diuji dengan mengaktifkan semua API privasi Iklan di chrome://settings/adPrivacy.

Menggunakan demo

Demo tersedia, dan Anda dapat meninjau kodenya 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 Penayang A dan Penayang 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, Sesuaikan pengalaman penggunaan untuk pelanggan yang dikenal, dan Jalankan pengujian A/B.

Untuk demo Agregasi Pribadi, Anda dapat melihat pratinjau Mengukur jangkauan unik yang unik, Mengukur jangkauan frekuensi K+. Mengukur demografi pengguna, dan

Men-debug worklet Penyimpanan Bersama dengan DevTools

Untuk memeriksa worklet Penyimpanan Bersama yang dimulai dari halaman tempat Anda berada, 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 berumur pendek saat startup.

Men-debug worklet Penyimpanan Bersama dengan menambahkan pemroses tingkat peristiwa.
Titik henti sementara dapat ditambahkan ke worklet Penyimpanan Bersama.

Selain itu, halaman chrome://inspect/#shared-storage-worklets akan 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.