Użyj Workletu współdzielonej pamięci masowej, aby zidentyfikować znanych klientów.
Interfejs Shared Storage API to propozycja Piaskownicy prywatności do ogólnego użytku, przechowywania danych w różnych witrynach, która obsługuje wiele możliwych zastosowań. Jednym z przykładów jest identyfikowanie znanych klientów, które można przetestować w Chrome w wersji 104.0.5086.0 i nowszych.
Możesz przechowywać, czy użytkownik zarejestrował się w Twojej witrynie, w pamięci współdzielonej, a potem renderować osobny element na podstawie tego, czy użytkownik jest w stanie zapisanych danych (czy użytkownik jest „znanym” klientem).
Ustaw znanych klientów
Aby przeprowadzić eksperyment z identyfikacją znanych klientów w pamięci współdzielonej, potwierdź, że używasz Chrome w wersji 104.0.5086.0 lub nowszej. Następnie włącz flagę eksperyment z interfejsami API reklam w Piaskownicy prywatności na stronie chrome://flags/#privacy-sandbox-ads-apis
.
Możesz też włączyć pamięć współdzieloną, używając flagi --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
w wierszu poleceń.
Eksperymentuj z przykładami kodu
Możesz renderować inny element w zależności od tego, czy użytkownik wyświetlił się w innej witrynie. Dostawca usług płatniczych może na przykład ustawić przycisk „Zarejestruj się” lub „Kup teraz” w zależności od tego, czy użytkownik zarejestrował się w witrynie dostawcy usług płatniczych. Pamięci współdzielonej można używać do określania stanu użytkownika i dostosowywania jego obsługi na podstawie tego stanu.
W tym przykładzie:
- Element
known-customer.js
jest umieszczony w ramce. Ten skrypt ustawia opcje, które spowodują wyświetlenie przycisku na stronie: „Zarejestruj się” lub „Kup teraz”. known-customer-worklet.js
to worklet pamięci współdzielonej, który określa, czy użytkownik jest znany. Jeśli użytkownik jest znany, informacje są zwracane. Jeśli użytkownik jest nieznany, informacje te są zwracane i wyświetlany jest przycisk „Zarejestruj”, a użytkownik zostaje oznaczony jako znany z przyszłości.
// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
{ url: `https://${advertiserUrl}/ads/register-button.html` },
{ url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];
async function injectButton() {
// Load the worklet module
await window.sharedStorage.worklet.addModule('known-customer-worklet.js');
// Set the initial status to unknown ('0' is unknown and '1' is known)
window.sharedStorage.set('known-customer', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose the button based on the user status
const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('button-slot').src = fencedFrameConfig;
}
injectButton();
class SelectURLOperation {
async run(urls) {
const knownCustomer = await this.sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
Przypadki użycia
To tylko niektóre z możliwych zastosowań pamięci współdzielonej. W miarę otrzymywania opinii i odkrywania nowych przypadków użycia będziemy dodawać kolejne przykłady.
Wybór treści
Wybieraj i wyświetlaj różne treści na różnych stronach w ogrodzonych ramkach na podstawie informacji zebranych w pamięci współdzielonej. Bramką wyjściową dla tych przypadków użycia jest wybór adresu URL.
- Rotacja kreacji: przechowuj dane, np. identyfikator kreacji, liczbę wyświetleń i interakcje użytkowników, aby określać, które kreacje widzą użytkownicy w różnych witrynach.
- Testy A/B: możesz przypisać użytkownika do grupy eksperymentalnej, a potem zapisać tę grupę w pamięci współdzielonej, aby mieć do niej dostęp w różnych witrynach.
- Niestandardowe wrażenia użytkowników: udostępniaj niestandardowe treści i wezwania do działania wybrane na podstawie stanu rejestracji użytkownika lub innych stanów użytkownika.
Generowanie raportów podsumowujących
Gromadzenie informacji w pamięci współdzielonej i generowanie szczegółowego raportu podsumowującego. Bramką wyjściową dla tych przypadków użycia jest Private Aggregation API.
- Pomiar zasięgu wśród unikalnych użytkowników: wielu producentów treści i reklamodawców chce wiedzieć, ilu unikalnych użytkowników zobaczyło ich treści. Korzystaj z pamięci współdzielonej, by rejestrować, kiedy użytkownik po raz pierwszy zobaczył Twoją reklamę, umieszczony film lub publikację, i zapobiec zduplikowaniu tego samego użytkownika w różnych witrynach. Następnie możesz użyć interfejsu Private Aggregation API, aby wygenerować raport podsumowujący dla Twojego zasięgu.
- Pomiar danych demograficznych: twórcy treści często chcą poznać dane demograficzne swoich odbiorców. Możesz wykorzystać pamięć współdzieloną, aby rejestrować dane demograficzne użytkowników w kontekście, w jakim są dostępne (np. w Twojej własnej witrynie), a potem generować raporty na ich temat obejmujące wiele innych witryn, na przykład treści umieszczone na innej stronie.
- Pomiar częstotliwości K+: czasami określany jako „efektywna częstotliwość” występuje często minimalna liczba wyświetleń, zanim użytkownik rozpozna lub zapamięta określone treści (często w kontekście wyświetleń reklamy). Możesz wykorzystać pamięć współdzieloną, aby tworzyć raporty o unikalnych użytkownikach, którzy widzieli treść co najmniej tyle razy.
Angażuj i dziel się opiniami
Oferta pamięci współdzielonej jest obecnie przedmiotem dyskusji i w przyszłości może ulec zmianie. Jeśli wypróbowujesz ten interfejs API i chcesz podzielić się opinią, chętnie poznamy Twoją opinię.
- GitHub przeczytaj ofertę, zadawaj pytania i bierz udział w dyskusji.
- Powiadomienia dotyczące interfejsu Shared Storage API: dołącz do naszej listy adresowej lub sprawdź wcześniejsze ogłoszenia.
- Pomoc dla deweloperów: zadawaj pytania i bierz udział w dyskusjach w repozytorium pomocy dla deweloperów Piaskownicy prywatności.