Panoramica dello spazio di archiviazione condiviso

Consenti accesso in scrittura illimitato allo spazio di archiviazione tra siti con un accesso in lettura che tutela la privacy.

Stato implementazione

Questo documento illustra una proposta per l'archiviazione non partizionata tra siti: l'API Shared Storage.

Proposta Stato
Report a livello di evento per Selezione dei contenuti (selectURL()) Disponibile almeno fino al 2026
Budget per sito
Spiegazione		 Disponibile nella versione M119
Consenti la scrittura dalle intestazioni delle risposte
Explainer
Problema di GitHub		 Disponibile in M124. Possibilità di attivazione manuale in M119-M123
Timeout del contributo per l'aggregazione privata
Explainer		 Disponibile nella versione M119
Debug dei worklet dello spazio di archiviazione condiviso con DevTools
Sezione		 Disponibile in M120
Aggiorna il limite di spazio di archiviazione dei dati dello spazio di archiviazione condiviso a 5 MB
Explainer		 Disponibile in M124

Perché abbiamo bisogno di questa API?

Per impedire il monitoraggio degli utenti su più siti, i browser vengono partizionamento tutte le forme di archiviazione (cookie, localStorage, cache e così via). Tuttavia, esistono di casi d'uso legittimi che si basano sullo spazio di archiviazione non partizionato impossibile senza l'aiuto delle nuove API web. Ad esempio, un produttore di contenuti potresti voler misurare la copertura su diversi siti, senza fare affidamento su identificatori tra siti.

L'API Shared Storage consente ai siti di archiviare e accedere ai file tra siti. Questi dati devono essere letti in un ambiente sicuro per evitare o perdite di dati.

Puoi utilizzare i dati dello spazio di archiviazione condiviso in due modi:

A chi è destinato?

Esistono molti tipi diversi di aziende che possono trarre vantaggio dall'utilizzo dei l'API Shared Storage. Ad esempio:

  • I tecnici pubblicitari potrebbero misurare la copertura delle campagne, impostare quote limite e ruotare le creatività, tutte funzionalità che attualmente si basano su cookie di terze parti.
  • I fornitori di servizi di pagamento potrebbero determinare se un utente è un cliente esistente e personalizzare l'esperienza di pagamento.
  • Le aziende di sicurezza web possono creare una logica personalizzata per segnalare i comportamenti sospetti o pericolosi.

La tua azienda sta cercando soluzioni di archiviazione cross-site che non sono ancora state risolti? Condividi il tuo caso d'uso.

Casi d'uso

L'API Shared Storage intende supportare molti casi d'uso, sostituendo diversi usi esistenti dei cookie di terze parti. È incluso quanto segue:

Caso d'uso Descrizione Gate di output
Ruota le creatività degli annunci Puoi memorizzare dati come l'ID creatività, i conteggi delle visualizzazioni e le interazioni degli utenti per stabilire quali vedere su diversi siti. In questo modo puoi bilanciare le visualizzazioni ed evitare una sovrasaturazione di determinati contenuti, il che può aiutarti a evitare un'esperienza utente negativa. Selezione URL
Eseguire test A/B Puoi assegnare un utente a un gruppo sperimentale e poi archiviarlo in uno spazio di archiviazione condiviso per accedervi tra più siti. Selezione URL
Personalizzare l'esperienza utente per clienti conosciuti Puoi condividere contenuti personalizzati e inviti all'azione in base allo stato di registrazione di un utente o ad altri stati. Selezione URL
Mitigazioni contro i comportamenti illeciti Le organizzazioni che si occupano di anti-abuso, antifrode e di sicurezza web spesso usano tecniche di proprietà per rilevare gli utenti malintenzionati, che si tratti di bot automatizzati o persone reali che cercano di causare danni. Qui è possibile testare molte strategie diverse, che si tratti di utilizzare la porta di output di selezione URL per codificare una valutazione di affidabilità dell'utente o la porta di output di Private Aggregation per creare set di dati per il rilevamento di anomalie. Selezione degli URL, API Private Aggregation
Misurare la copertura unica Molti produttori e inserzionisti di contenuti spesso vogliono sapere quante persone uniche hanno visto i loro contenuti. Puoi utilizzare l'Archiviazione condivisa per generare report sulla prima volta che un utente ha visualizzato il tuo annuncio, il tuo video incorporato o la tua pubblicazione ed evitare un conteggio duplicato dello stesso utente su un altro sito, fornendoti un report aggregato sul rumore della tua unique reach approssimativa. API Private Aggregation
Misurare i dati demografici degli utenti I produttori di contenuti spesso vogliono conoscere i dati demografici del loro pubblico. Puoi utilizzare lo spazio di archiviazione condiviso per registrare i dati demografici degli utenti in un contesto in cui sono disponibili, ad esempio il tuo sito proprietario, e utilizzare i report aggregati per generare report su di essi su molti altri siti, ad esempio i contenuti incorporati. API Private Aggregation
Misurare la copertura di frequenza K+ A volte descritto come "frequenza effettiva", Spesso esiste un numero minimo di visualizzazioni prima che un utente riconosca o ricordi determinati contenuti (spesso nel contesto delle visualizzazioni dell'annuncio). Puoi utilizzare l'Archiviazione condivisa per creare report di utenti unici che hanno visualizzato dei contenuti almeno K volte. API Private Aggregation

La proposta intende creare un'API per uso generico che supporti molte possibili casi d'uso futuri. Ciò consente ulteriori sperimentazioni e cambiamenti, a crescere insieme all'ecosistema web.

Come funziona l'archiviazione condivisa?

Lo spazio di archiviazione condiviso consente di prendere decisioni consapevoli basate su dati cross-site, senza condividere le informazioni dell'utente (ad esempio, la cronologia del browser o altre informazioni (dettagli) con un sito di incorporamento o di esfiltrare i dati nei propri server.

Puoi scrivere nello spazio di archiviazione condiviso in qualsiasi momento, come altre API di archiviazione JavaScript come localStorage o IndexDB. A differenza delle altre API di archiviazione, puoi leggere i valori dello spazio di archiviazione condiviso solo in un ambiente sicuro, chiamato worklet dello spazio di archiviazione condiviso.

I worklet sono i punti in cui aggiungi la logica di business. All'interno del worklet puoi vedere autorizzato a leggere ed elaborare un valore da Archiviazione condivisa, ma non puoi restituiscono direttamente il valore esatto al chiamante del worklet. Per estrarre informazioni utili le informazioni dal worklet, una serie di "gate" sono disponibili. Esistono due metodi gate disponibili, ma potremmo aggiungerne altri in futuro.

Le porte di output disponibili dell'API Shared Storage sono:

  • Selezione di URL tra siti: puoi eseguire uno script di worklet per selezionare un URL da un elenco fornito in base ai dati archiviati, quindi eseguire il rendering dei contenuti in un frame recintato.
  • Aggregazione del rumore con l'API Private Aggregation: puoi eseguire un worklet per inviare dati tra siti tramite l'API Private Aggregation e restituire un report di riepilogo.

Prova l'API Shared Storage

API Shared Storage per la porta di output della selezione degli URL e l'output dell'aggregazione privata gate sono disponibili per i test. La selezione dei contenuti può essere testata in Chrome Canary/Dev/Beta M105+ e l'API Private Aggregation sono disponibili per i test in Chrome M107+ Canary e Dev. L'API può essere testata abilitando tutte le API di privacy per gli annunci in chrome://settings/adPrivacy.

Usa la demo

È disponibile una demo e puoi esaminare il codice su GitHub.

Questa demo è costruita dal punto di vista di un inserzionista, ad tech, un distributore di contenuti o un altro servizio di terze parti che vuole archiviare le informazioni dei vari publisher siti. Nella demo, lo stesso terzo verrà eseguito sui siti del Publisher A e del Publisher B per per ogni caso d'uso. Visita le pagine del publisher per vedere come i dati vengono condivisi in un contesto tra siti.

La demo contiene casi d'uso per la selezione dei contenuti e l'aggregazione privata.

Per la demo sulla selezione dei contenuti, Ruota creatività degli annunci Personalizzare l'esperienza d'uso per i clienti conosciuti e Sono disponibili casi d'uso di esecuzione di test A/B.

Per la demo di Aggregazione privata, puoi visualizzare in anteprima Misurare la copertura unica Misurare la copertura di frequenza K+ e Misurazione dei dati demografici degli utenti.

Esegui il debug dei worklet dello spazio di archiviazione condiviso con DevTools

Per esaminare i worklet dello spazio di archiviazione condiviso avviati dalla pagina in cui ti trovi, puoi visitare la scheda "Origini" nel riquadro DevTools e aggiungi "Worklet dello spazio di archiviazione condiviso / prima istruzione dello script" del listener di eventi. Questo punto di interruzione mette in pausa l'esecuzione iniziale dello script del modulo o i worklet di breve durata all'avvio.

Debug di un worklet di archiviazione condivisa aggiungendo un listener a livello di evento.
È possibile aggiungere un punto di interruzione a un worklet dello spazio di archiviazione condiviso.

Inoltre, la pagina chrome://inspect/#shared-storage-worklets mostra tutti i worklet attivi dello spazio di archiviazione condiviso da tutte le pagine.

Interagisci e condividi il feedback

La proposta di spazio di archiviazione condiviso è in fase di discussione attiva ed è soggetta a modifiche in futuro. Se provi questa API e hai feedback, ci piacerebbe conoscere la tua opinione.