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 tra siti, i browser partizionano tutte le forme di archiviazione (cookie, localStorage, cache e così via). Tuttavia, esistono una serie di casi d'uso legittimi che si basano su uno spazio di archiviazione non partizionato, cosa impossibile senza l'aiuto di nuove API web. Ad esempio, un produttore di contenuti potrebbe voler misurare la copertura su diversi siti, senza fare affidamento su identificatori cross-site.

L'API Shared Storage consente ai siti di archiviare dati tra siti non partizionati e di accedervi. Questi dati devono essere letti in un ambiente sicuro per evitare fughe 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 dell'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 gestite? Condividi il tuo caso d'uso.

Casi d'uso

L'API Shared Storage intende supportare molti casi d'uso, sostituendo diversi utilizzi 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 creatività vengono visualizzate dagli utenti sui 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", esiste spesso 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 molti possibili casi d'uso futuri. Ciò consente ulteriori sperimentazioni e cambiamenti che consentono di crescere insieme all'ecosistema web.

Come funziona l'archiviazione condivisa?

Lo spazio di archiviazione condiviso consente di prendere decisioni consapevoli basate su dati tra siti, senza condividere le informazioni degli utenti (come la cronologia del browser o altri dettagli personali) con un sito di incorporamento o con l'esfiltrazione dei dati nei tuoi 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 leggere ed elaborare un valore dello spazio di archiviazione condiviso, ma non puoi restituire direttamente il valore esatto al chiamante del worklet. Per estrarre informazioni utili dal worklet, è disponibile una serie di "gate". Sono disponibili due gate, 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

L'API Shared Storage per la porta di output della selezione degli URL e la porta di output dell'aggregazione privata sono disponibili per i test. La selezione dei contenuti può essere testata in Chrome Canary/Dev/Beta M105+ e l'API Private Aggregation è disponibile per i test in Chrome M107+ Canary e Dev. L'API può essere testata attivando 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 è creata dal punto di vista di un inserzionista, di una tecnologia pubblicitaria, di un distributore di contenuti o di un altro servizio di terze parti che vuole memorizzare informazioni su diversi siti di publisher. Nella demo, lo stesso codice di terze parti verrà eseguito sui siti del publisher A e del publisher B per ogni caso d'uso. Visita le pagine del publisher per vedere in che modo i dati vengono condivisi in un contesto cross-site.

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

Per la demo di selezione dei contenuti, sono disponibili i casi d'uso Ruota creatività annunci, Personalizzare l'esperienza d'uso per clienti noti e Eseguire test A/B.

Per la demo sull'aggregazione privata, puoi visualizzare l'anteprima di Misura la copertura unica Misura la copertura di frequenza K+. Misurare i dati demografici degli utenti e

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 aggiungere il punto di interruzione del listener di eventi "Worklet di archiviazione condivisa / Prima istruzione script". 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 tuo feedback

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