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 eseguono il partizionamento di tutte le forme di archiviazione (cookie, localStorage, cache e così via). Tuttavia, esistono numerosi casi d'uso legittimi che si basano sullo spazio di archiviazione non partizionato, che sarebbero impossibili senza l'aiuto delle nuove API web. Ad esempio, un produttore di contenuti potrebbe voler misurare la copertura su diversi siti, senza fare affidamento sugli identificatori tra siti.

L'API Shared Storage consente ai siti di archiviare dati cross-site non partizionati e accedervi. Questi dati devono essere letti in un ambiente sicuro per evitare perdite.

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

A chi è rivolto questo servizio?

Esistono molti tipi 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 possono stabilire se un utente è un cliente esistente e personalizzare l'esperienza di pagamento.
  • Le aziende che si occupano di sicurezza web possono creare una logica personalizzata per segnalare comportamenti sospetti o pericolosi.

La tua azienda sta cercando soluzioni di archiviazione tra siti che non hanno ancora ricevuto soluzioni? Condividi il tuo caso d'uso.

casi d'uso

L'API Shared Storage intende supportare molti casi d'uso, sostituendo diversi utilizzi esistenti per i cookie di terze parti. Include:

Caso d'uso Descrizione Porta di output
Ruota le creatività degli annunci Puoi memorizzare dati quali ID creatività, numero di visualizzazioni e interazione dell'utente per stabilire quale creatività mostrare agli utenti sui diversi siti. In questo modo puoi bilanciare le visualizzazioni ed evitare una saturazione eccessiva di determinati contenuti, contribuendo a evitare un'esperienza utente negativa. Selezione URL
Eseguire test A/B Puoi assegnare un utente a un gruppo sperimentale e poi conservarlo in uno spazio di archiviazione condiviso per accedere ai vari siti. Selezione URL
Personalizzare l'esperienza utente per i clienti noti Puoi condividere inviti all'azione e contenuti personalizzati in base allo stato di registrazione o ad altri stati dell'utente. Selezione URL
Mitigazioni anti-abuso Le organizzazioni contro i comportamenti illeciti, le frodi e la sicurezza web spesso usano tecniche di proprietà per rilevare gli utenti malintenzionati, che si tratti di bot automatizzati o persone reali che tentano di causare danni. Qui è possibile testare molte strategie diverse, che si tratti di utilizzare la porta di output Selezione URL per codificare una valutazione di affidabilità dell'utente o la porta di output di aggregazione privata per creare set di dati per il rilevamento di anomalie. Selezione URL, API Private Aggregation
Misurare la copertura unica Molti produttori e inserzionisti di contenuti vogliono spesso sapere quante persone uniche hanno visto i loro contenuti. Puoi utilizzare lo spazio di archiviazione condiviso per generare report la prima volta che un utente ha visto il tuo annuncio, il tuo video incorporato o la tua pubblicazione, nonché evitare il doppio conteggio dello stesso utente su un sito diverso, fornendoti un report aggregato sulla tua unique reach approssimativa. API Private Aggregation
Misurare i gruppi 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 specifico, ad esempio il tuo sito proprietario, e utilizzare i report aggregati per generare report su questi dati su molti altri siti, ad esempio i contenuti incorporati. API Private Aggregation
Misurare la copertura di frequenza K+ A volte definita "frequenza effettiva", spesso esiste un numero minimo di visualizzazioni prima che un utente riconosca o richiami determinati contenuti (spesso nel contesto delle visualizzazioni pubblicitarie). Puoi utilizzare lo spazio di archiviazione condiviso per creare report sugli utenti unici che hanno visualizzato un contenuto almeno K volte. API Private Aggregation

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

Come funziona l'archiviazione condivisa?

Lo spazio di archiviazione condiviso ti consente di prendere decisioni informate in base ai dati tra siti, senza condividere le informazioni degli utenti (come la cronologia del browser o altri dettagli personali) con un sito di incorporamento o l'esfiltrazione di dati ai tuoi server.

Puoi scrivere nello spazio di archiviazione condiviso in qualsiasi momento, ad esempio 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, noto come worklet dello spazio di archiviazione condiviso.

I worklet sono il punto in cui aggiungi la logica di business. All'interno del worklet, puoi leggere ed elaborare un valore dall'archiviazione condivisa, ma non puoi restituire direttamente il valore esatto al chiamante del worklet. Per estrarre informazioni utili dal worklet, è disponibile un insieme di "gate". Sono disponibili due gate, ma potrebbero essere aggiunti 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, e quindi eseguire il rendering dei contenuti in un frame isolato.
  • Aggregazione 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 dell'URL e la porta di output di aggregazione privata sono disponibili per i test. La selezione dei contenuti può essere testata in Chrome Canary/Dev/Beta M105 e versioni successive e l'API Private Aggregation è disponibile per i test nelle versioni canary e Dev di Chrome M107 e versioni successive. È possibile testare l'API attivando il flag Esperimento sulle API degli annunci Privacy Sandbox all'indirizzo chrome://flags/#privacy-sandbox-ads-apis.

Per utilizzare queste API, attiva l'esperimento sulle API degli annunci di Privacy Sandbox.

Utilizza la demo

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

Questa demo è creata dal punto di vista di un inserzionista, un ad tech, un distributore di contenuti o un altro servizio di terze parti che vuole archiviare le informazioni sui siti di diversi publisher. Nella demo, il codice della stessa terza parte verrà eseguito su entrambi i siti del Publisher A e del Publisher B 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, sono disponibili i casi d'uso Ruota le creatività degli annunci, Personalizzare l'esperienza di utilizzo per i clienti noti ed Eseguire test A/B.

Per la demo sull'aggregazione privata, puoi visualizzare un'anteprima di Misura la copertura unica e Misura la copertura frequenza più alta. Misurare i dati demografici degli utenti e

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

Per esaminare i worklet dell'archiviazione condivisa avviati dalla pagina in cui ti trovi, puoi andare alla scheda "Origini" nel riquadro DevTools e aggiungere il punto di interruzione del listener di eventi "Worklet dell'archiviazione condivisa / Prima istruzione dello script". Questo punto di interruzione metterà in pausa l'esecuzione iniziale dello script del modulo o i worklet di breve durata all'avvio.

Debug di un worklet dello spazio di archiviazione condiviso mediante l'aggiunta di 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 dello spazio di archiviazione condiviso attivi di 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.