Zezwalaj na nielimitowany dostęp do pamięci z możliwością zapisu w pamięci innej witryny z zachowaniem ochrony prywatności.
Stan implementacji
Ten dokument przedstawia propozycję niepartycjonowania pamięci masowej w innej witrynie: interfejsu Shared Storage API.
- The Shared Storage API has now moved to general availability.
- A live demo is available, as is testing:
- URL selection output gate is available for local testing from Chrome M105+.
- Private Aggregation output gate is available for local testing from Chrome M107+.
- Measurement with the Private Aggregation API is now in general availability.
- Chrome platform status
| Proposal | Status |
|---|---|
Event-level reporting for Content Selection (selectURL()) |
Available until at least 2026 |
| Per-site budgeting Explainer |
Available in M119 |
| Allow writing from response headers Explainer GitHub Issue |
Available in M124. Can be manually enabled in M119-M123 |
| Private Aggregation contribution timeout Explainer |
Available in M119 |
| Debugging Shared Storage worklets with DevTools Section |
Available in M120 |
| Update Shared Storage data storage limit to 5MB Explainer |
Available in M124 |
Do czego potrzebny jest ten interfejs API?
Aby zapobiec śledzeniu użytkowników w różnych witrynach, przeglądarki partycjonują wszystkie formy pamięci (pliki cookie, pamięć lokalna, pamięć podręczna itp.). Istnieje jednak wiele uzasadnionych przypadków użycia korzystających z pamięci niepartycjonowanej, co byłoby niemożliwe bez pomocy nowych internetowych interfejsów API. Producent treści może na przykład chcieć mierzyć zasięg w różnych witrynach, nie korzystając z identyfikatorów pochodzących z różnych witryn.
Interfejs Shared Storage API umożliwia witrynom przechowywanie niepartycjonowanych danych z różnych witryn i korzystanie z nich. Te dane należy odczytywać w bezpiecznym środowisku, aby zapobiec wyciekom.
Danych z pamięci współdzielonej możesz używać na dwa sposoby:
- Wybór treści z innych witryn.
- Zaszumiona agregacja danych z różnych witryn przy użyciu interfejsu Private Aggregation API
Dla kogo jest to przypomnienie?
Jest wiele różnych firm, które mogą skorzystać na korzystaniu z interfejsu Shared Storage API. Na przykład:
- Technologie reklamowe mogą mierzyć zasięg kampanii, ustawiać limity wyświetleń na użytkownika i rotować kreacje. Wszystkie te elementy wykorzystują obecnie pliki cookie innych firm.
- Dostawcy usług płatniczych mogą określić, czy użytkownik jest obecnym klientem, i dostosować proces płatności.
- Firmy zajmujące się bezpieczeństwem sieci mogą tworzyć własne logiki do oznaczania podejrzanych lub niebezpiecznych zachowań.
Czy Twoja firma szuka rozwiązań do przechowywania danych w różnych witrynach, które nie zostały jeszcze rozwiązane? Udostępnij swój przypadek użycia.
Przykłady zastosowań
Interfejs Shared Storage API będzie obsługiwać wiele przypadków użycia i zastąpi kilka dotychczasowych zastosowań plików cookie innych firm. Obejmuje to m.in.:
| Przypadek użycia | Opis | Bramka wyjściowa |
|---|---|---|
| Rotacja kreacji | Możesz przechowywać takie dane jak identyfikator kreacji, liczba wyświetleń i interakcje użytkownika, by określać, które kreacje użytkownicy widzą w poszczególnych witrynach. Pozwala to zrównoważyć liczbę wyświetleń i uniknąć przesycenia pewnych treści, co może pomóc uniknąć negatywnych emocji. | Wybór adresu URL |
| Przeprowadzanie testów A/B | Możesz przypisać użytkownika do grupy eksperymentalnej, a następnie zapisać tę grupę w pamięci współdzielonej, aby można było z niej korzystać na innych stronach. | Wybór adresu URL |
| Dostosowywanie interfejsu do znanych klientów | Możesz udostępniać własną treść i wezwania do działania na podstawie stanu rejestracji lub innych stanów użytkownika. | Wybór adresu URL |
| Środki zapobiegające nadużyciom | Organizacje przeciwdziałania nadużyciom i oszustwom oraz związane z bezpieczeństwem sieci często używają zastrzeżonych technik do wykrywania szkodliwych użytkowników – czy to zautomatyzowane boty, czy prawdziwe osoby próbujące wyrządzić krzywdę. W tym miejscu można przetestować wiele różnych strategii – może to być użycie bramki wyjściowej wyboru adresu URL do kodowania oceny wiarygodności użytkownika lub bramki wyjściowej agregacji prywatnej do tworzenia zbiorów danych do wykrywania anomalii. | Wybór adresów URL, Private Aggregation API |
| Pomiar zasięgu wśród unikalnych użytkowników | Wielu producentów treści i reklamodawców często chce wiedzieć, ile unikalnych osób zobaczyło ich treści. Możesz korzystać z Współdzielonej pamięci, aby po raz pierwszy zobaczyć, kiedy użytkownik zobaczył Twoją reklamę, umieszczony film lub publikację, a także zapobiec wielokrotnemu zliczaniu tego samego użytkownika w innej witrynie. W ten sposób uzyskasz zbiorcze raporty o przybliżonym zasięgu wśród unikalnych użytkowników. | Interfejs Private Aggregation API |
| Pomiar danych demograficznych użytkowników | Producenci treści często chcą poznać dane demograficzne swoich odbiorców. Możesz korzystać z pamięci współdzielonej, aby rejestrować dane demograficzne użytkowników w miejscu, w którym je masz, np. w swojej własnej witrynie, i korzystać z raportów zbiorczych do tworzenia raportów dotyczących tych danych w wielu innych witrynach, takich jak umieszczone treści. | Interfejs Private Aggregation API |
| Pomiar zasięgu częstotliwości K+ | Czasem nazywany „efektywną częstotliwością” – do rozpoznania lub rozpoznania przez użytkownika określonej treści (często w kontekście wyświetleń reklam) występuje często minimalna liczba wyświetleń. Udostępniana pamięć masowa może służyć do tworzenia raportów o unikalnych użytkownikach, którzy widzieli daną treść co najmniej K razy. | Interfejs Private Aggregation API |
Celem tej oferty jest stworzenie interfejsu API ogólnego przeznaczenia, który będzie obsługiwał wiele możliwych w przyszłości zastosowań. Pozwala to na dalsze eksperymentowanie i wprowadzanie zmian w ramach ekosystemu internetowego.
Jak działa pamięć współdzielona?
Pamięć współdzielona umożliwia podejmowanie świadomych decyzji na podstawie danych z różnych witryn bez udostępniania informacji o użytkowniku (np. historii przeglądania czy innych danych osobowych) witrynom osadzonym i wydobywania danych na własne serwery.
W pamięci współdzielonej możesz w dowolnym momencie zapisywać, tak jak w przypadku innych interfejsów API do przechowywania danych w języku JavaScript, takich jak localStorage czy indexDB. W przeciwieństwie do innych interfejsów API do przechowywania danych wartości pamięci współdzielonej możesz odczytywać tylko w bezpiecznym środowisku nazywanym listem pamięci współdzielonej.
Worklety to miejsca, w których dodajesz logikę biznesową. W Worklet możesz odczytywać i przetwarzać wartość z pamięci współdzielonej, ale nie możesz bezpośrednio zwrócić dokładnej wartości obiektowi wywołującemu Worklet. Aby wyodrębnić przydatne informacje z Workletu, jest dostępny zestaw „bram”. Dostępne są 2 bramki, ale w przyszłości możemy dodać ich więcej.
Dostępne bramy wyjściowe interfejsu Shared Storage API:
- Wybór adresu URL z innej witryny: możesz uruchomić skrypt Worklet, aby na podstawie zapisanych danych wybrać adres URL z podanej listy, a następnie wyrenderować treść w zabezpieczonej ramce.
- Agregacja zaszumiona w interfejsie Private Aggregation API: możesz uruchomić Worklet, aby wysyłać dane z innych witryn przez Private Aggregation API i zwrócić raport z podsumowaniem.
Wypróbuj interfejs Shared Storage API
Do testowania są dostępne bramki wyjściowe wyboru adresu URL i bramka wyjściowa agregacji prywatnej (Shared Storage API). Wybór treści można przetestować w Chrome Canary/Dev/Beta w wersji M105 lub nowszej. Interfejs Private Aggregation API jest dostępny do testowania w Chrome M107+ w wersji Canary i deweloperskiej. Interfejs można przetestować, włączając wszystkie interfejsy Ad Privacy API w sekcji chrome://settings/adPrivacy.
Skorzystaj z wersji demonstracyjnej
Dostępna jest wersja demonstracyjna, a kod możesz przejrzeć na GitHub.
Prezentację przedstawia reklamodawca, technika reklamowa, dystrybutor treści lub inna usługa zewnętrzna, która chce przechowywać informacje w witrynach różnych wydawców. W wersji demonstracyjnej w witrynach wydawcy A i wydawcy B będzie działać w każdym przypadku ten sam kod firmy zewnętrznej. Wejdź na strony wydawcy, aby sprawdzić, jak dane są udostępniane w kontekście innej witryny.
Wersja demonstracyjna zawiera przypadki użycia wyboru treści i agregacji prywatnej.
W przypadku demonstracji wyboru treści dostępne są opcje: Wyświetlaj naprzemiennie kreacje, Dostosuj sposób korzystania z usługi w przypadku znanych klientów i Przeprowadzaj testy A/B.
W przypadku wersji demonstracyjnej agregacji prywatnej możesz zobaczyć podgląd unikalnych opcji Mierz zasięg wśród unikalnych użytkowników i Mierz zasięg częstotliwości K+. mierzyć dane demograficzne użytkowników,
Debuguj Worklety pamięci współdzielonej za pomocą Narzędzi deweloperskich
Aby sprawdzić Worklety pamięci współdzielonej uruchomione na bieżącej stronie, otwórz kartę „Źródła” w panelu Narzędzi deweloperskich i dodaj punkt przerwania detektora zdarzeń „Worklet Shared Storage / Pierwsza instrukcja skryptu”. Ten punkt przerwania wstrzyma początkowe wykonanie skryptu modułu lub krótkotrwałe Worklety podczas uruchamiania.
Dodatkowo na stronie chrome://inspect/#shared-storage-worklets wyświetlają się wszystkie aktywne Worklety pamięci współdzielonej ze wszystkich stron.
Engage and share feedback
The Shared Storage proposal is under active discussion and subject to change in the future. If you try this API and have feedback, we'd love to hear it.
- GitHub: Read the proposal, raise questions and participate in discussion.
- Shared Storage API announcements: Join or view past announcements on our mailing list
- Developer support: Ask questions and join discussions on the Privacy Sandbox Developer Support repo.