Interfejs Storage API udostępnionego umożliwia witrynom przechowywanie danych i dostęp do nich, które nie są izolowane przez witrynę najwyższego poziomu. Umożliwia to i ułatwia stosowanie w wielu witrynach przy jednoczesnym poszanowaniu prywatności użytkowników.
Chrome ma partycjonowaną pamięć masową i przechodzi na nowe rozwiązanie, które priorytetowo traktuje wybór użytkownika w przypadku plików cookie innych firm. Istnieje jednak kilka uzasadnionych przypadków użycia, które opierają się na niepartycjonowanej pamięci masowej. Nie byłoby to możliwe bez pomocy nowych interfejsów API internetowych. Na przykład producent treści może chcieć mierzyć zasięg treści w różnych witrynach bez polegania na identyfikatorach międzywitrynowych. Interfejs Shared Storage API spełnia tę potrzebę, oferując bardziej prywatny mechanizm przechowywania danych bez partycji i dostępu do nich w różnych witrynach.
Czym jest interfejs Shared Storage API?
Interfejs Shared Storage API to interfejs do przechowywania danych o ogólnym zastosowaniu, który umożliwia stosowanie w różnych witrynach z zachowaniem prywatności. Interfejs SharedStorage ma funkcje podobne do interfejsów localStorage i sessionStorage. Jest to pamięć klucz-wartość, do której można zapisywać dane w dowolnym momencie. W przeciwieństwie do innych interfejsów Web Storage dane z Shared Storage mogą być udostępniane w różnych witrynach najwyższego poziomu, ale mogą być odczytywane tylko z bezpiecznego środowiska i wyprowadzane za pomocą interfejsów Output API z ograniczonym dostępem.
Na diagramie powyżej widać, że witryna shoes.example może być umieszczana w innych witrynach wydawców, takich jak news.example, i nadal mieć dostęp do tych samych danych.
Ta funkcja udostępnionego magazynu umożliwia korzystanie z funkcji w różnych witrynach, a jednocześnie zwiększa prywatność użytkowników, zapobiegając śledzeniu poszczególnych osób odwiedzających witrynę i ograniczając dostęp do danych. Dostęp do danych jest możliwy tylko w bezpiecznym środowisku z ograniczonymi możliwościami wyjścia (workletów).
Shared Storage to podstawowa infrastruktura magazynowania danych dla ograniczonej liczby interfejsów Output API. Interfejs Output API to jedyny sposób na korzystanie z danych z Shared Storage. Interfejsy API wyjściowe:
- Wybierz adres URL: wybierz adres URL z podanej listy na podstawie zapisanych danych, a następnie wyświetl te treści w odizolowanej ramce.
- Private Aggregation: wysyłaj dane z wielu witryn za pomocą interfejsu Private Aggregation API, aby wygenerować raport podsumowujący.
Dlaczego potrzebujemy wspólnego miejsca na dane?
Interfejs Shared Storage API to elastyczny mechanizm przechowywania, którego deweloperzy internetowi mogą używać w połączeniu z interfejsami API wyjściowymi do obsługi wielu zastosowań, w tym do zastąpienia kilku dotychczasowych zastosowań plików cookie innych firm. Dowiedz się więcej o potencjalnych zastosowaniach interfejsów API dotyczących danych wyjściowych: Select URL i Private Aggregation.
Czy Twoja firma szuka rozwiązań dotyczących przechowywania danych w wielu witrynach, które nie zostały jeszcze opracowane? Możesz udostępnić swój przypadek użycia i utworzyć zgłoszenie w źródełkowym repozytorium Shared Storage na GitHubie.
Interfejsy wyjściowe i przypadki użycia zgodne ze współdzieloną pamięcią masową
| Interfejs Output API | Przypadek użycia | Opis |
|---|---|---|
| Wybierz adres URL | Rotacja kreacji reklamowych | Możesz przechowywać dane, takie jak identyfikator kreacji, liczba wyświetleń i interakcje użytkowników, aby określić, które kreacje widzą użytkownicy w różnych witrynach. Dzięki temu możesz zrównoważyć wyświetlenia i uniknąć przepełnienia określonych treści, co może negatywnie wpłynąć na wrażenia użytkownika. |
| Wybierz adres URL | Przeprowadzanie testów A/B | Test A/B porównuje co najmniej 2 wersje konfiguracji, aby określić, która z nich jest najskuteczniejsza. Możesz przypisać użytkownika do grupy eksperymentalnej, a potem zapisać tę grupę w Shared Storage, aby umożliwić dostęp do niej z różnych witryn. |
| Wybierz adres URL | Dostosowywanie interakcji z użytkownikiem w przypadku znanych klientów | Możesz udostępniać treści i wezwania do działania na podstawie stanu rejestracji użytkownika lub innych stanów użytkownika. |
| Wybierz URL, Prywatna agregacja | Środki zapobiegające nadużyciom | Organizacje zajmujące się zwalczaniem nadużyć, oszustw i zagrożeń internetowych często używają własnych metod wykrywania szkodliwych użytkowników, niezależnie od tego, czy są to automatyczne boty, czy prawdziwi ludzie, którzy próbują wyrządzić szkody. W tym przypadku można testować wiele różnych strategii, np. użyć interfejsu Select URL API do zakodowania oceny wiarygodności użytkownika lub interfejsu Private Aggregation API do tworzenia zbiorów danych na potrzeby wykrywania anomalii. |
| Aggregacja prywatna | Pomiar zasięgu wśród unikalnych użytkowników | Wielu twórców treści i reklamodawców często chce wiedzieć, ile unikalnych osób obejrzało wyświetlane treści. Za pomocą pamięci współdzielonej możesz śledzić, kiedy użytkownik po raz pierwszy zobaczy Twoją reklamę, osadzenie filmu lub publikację. Możesz zapobiec podwójnemu zliczaniu tego samego użytkownika w innej witrynie i wygenerować zagregowany raport z niepożądanymi danymi, aby oszacować zasięg unikalnych treści. |
| Aggregacja prywatna | Mierz dane demograficzne użytkowników | Twórcy treści chętnie poznają dane demograficzne swoich odbiorców. Shared Storage umożliwia zbieranie danych demograficznych użytkowników w Twojej witrynie i wykorzystywanie raportów zbiorczych do analizowania tych informacji na różnych platformach, np. w ramach treści osadzonych. |
| Aggregacja prywatna | Pomiar zasięgu przy częstotliwości K+ | Czasami określana jako „skuteczna częstotliwość”. Często występuje minimalna liczba wyświetleń, zanim użytkownik rozpozna lub przypomni sobie dany materiał (często w kontekście wyświetleń reklam). Możesz używać współdzielonego miejsca na dane do tworzenia raportów o unikajnych użytkownikach, którzy obejrzeli dany element treści co najmniej K razy. |
Jak działa wspólne miejsce na dane?
Udostępniona pamięć pozwala podejmować świadome decyzje na podstawie danych z wielu witryn, bez udostępniania informacji o użytkownikach (takich jak historia przeglądarki lub inne dane osobowe) witrynie, w której umieszczono treści, ani wyprowadzania danych na własne serwery.
W dowolnym momencie możesz zapisywać dane w pamięci współdzielonej, ale odczyt wartości z pamięci współdzielonej jest możliwy tylko w bezpiecznym środowisku, zwanym workletem.
Worklety Shared Storage to miejsce, w którym dodajesz logikę biznesową, a następnie odczytuje i przetworzysz wartość z Shared Storage, nie zwracając bezpośrednio do wywołującego workletu dokładnej wartości. Aby wyodrębnić informacje z workleta, możesz użyć interfejsów API Private Aggregation lub Select URL Output. W miarę zgłaszania nowych przypadków użycia mogą być udostępniane dodatkowe interfejsy Output API.
Stan interfejsu API
Interfejs Shared Storage API jest ogólnie dostępny. Postępuj zgodnie z instrukcjami, aby zarejestrować się w Piaskownicy prywatności, używać interfejsu API lub włączyć go do celów rozwoju lokalnego.
| Proposal | Status |
|---|---|
| Allow writing from response headers Explainer GitHub Issue |
Available in M124. Can be manually enabled in M119-M123 |
| Debugging Shared Storage worklets with DevTools Section |
Available in M120 |
| Update Shared Storage data storage limit to 5MB Explainer |
Available in M124 |
createWorklet() to create cross-origin worklets without an iframe |
Available in M125 |
Allow cross-origin script in addModule(), and align createWorklet() to match the behavior |
Available in M130 |
Custom data origin support in createWorklet()Explainer |
Expected in Q1 2025 |
| Allow Shared Storage worklet to read interest groups Explainer |
Expected in Q1 2025 |
| Debugging Shared Storage worklets with DevTools Explainer GitHub issue |
Expected in Q1 2025 |
Engage and share feedback
Note that the Shared Storage API proposal is under active discussion and development and therefore subject to change.
We're eager to hear your thoughts on the Shared Storage API.
- Proposal: Review the detailed proposal.
- Discussion: Join the ongoing discussion to ask questions and share your insights.
Stay Informed
- Mailing List: Subscribe to our mailing list for the latest updates and announcements related to the Shared Storage API.
Need Help?
- Developer Support: Connect with other developers and get answers to your questions in the Privacy Sandbox Developer Support repository.