Użyj Worklet Shared Storage, aby zidentyfikować znanych klientów.
Shared Storage API to interfejs Privacy, Propozycja piaskownicy do zwykłych obciążeń, pamięci w wielu witrynach, która obsługuje wiele możliwych zastosowań. Jednym z przykładów jest identyfikowanie znanych klientów, co jest dostępne do testowania w Chrome 104.0.5086.0 i nowszych.
Możesz zapisywać, czy użytkownik zarejestrował się w Twojej witrynie w pamięci współdzielonej, a następnie renderować osobny element w zależności od tego, czy informacje o stanie środków zapisywanych przez użytkownika (czyli użytkownik „znany” klienta).
Ustaw znanych klientów
Aby poeksperymentować z identyfikacją znanych klientów w pamięci współdzielonej, upewnij się, że używasz Chrome 104.0.5086.0 lub nowszej wersji. Włącz wszystkie interfejsy Ad Privacy API w sekcji chrome://settings/adPrivacy
.
Możesz też włączyć pamięć współdzieloną, używając flagi --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
w wierszu poleceń.
Eksperyment z przykładowym kodem
Możesz wyświetlać inny element w zależności od tego, czy użytkownik widział go w innej witrynie. Dostawca usług płatniczych może na przykład chcieć renderować „Zarejestruj się” lub „Kup teraz” w zależności od tego, czy użytkownik zarejestrował się w witrynie dostawcy usług płatniczych. W pamięci współdzielonej można określić stan użytkownika i dostosować go do własnych potrzeb.
W tym przykładzie:
- Element
known-customer.js
jest osadzony w ramce. Ten skrypt ustawia opcje, dla których przycisk powinien być wyświetlany w witrynie – „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 zostaną zwrócone. Jeśli użytkownik jest nieznany, informacje te wracają i wyświetla się komunikat „Register” (Zarejestruj). , a użytkownik zostanie 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 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. Na dodajemy przykłady. otrzymuj opinie i odkrywać nowe przypadki użycia.
Wybór treści
Wybieraj i wyświetlaj różne treści w różnych witrynach w chronione ramki na podstawie informacji zbierane w pamięci współdzielonej. Bramką wyjściową w tych przypadkach użycia jest wybór adresu URL.
- Rotacja kreacji: Przechowuj dane, takie jak identyfikator kreacji, liczba wyświetleń i interakcje użytkowników, aby określać, którzy użytkownicy które można zobaczyć na różnych stronach.
- Testy 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ć w innych witrynach.
- Funkcje dostosowane do potrzeb użytkowników: udostępniać treści niestandardowe i wezwania do działania na podstawie stanu rejestracji lub innych stanów użytkownika;
Generowanie raportów podsumowujących
Zbieranie informacji za pomocą pamięci współdzielonej oraz generowanie zaszumionego, zbiorczego 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 się dowiedzieć, ile unikalnych osób zobaczyło ich treści. Rejestrowanie pierwszego użytkownika za pomocą pamięci współdzielonej zobaczyli Twoją reklamę, umieszczony film lub publikację, zliczanie tego samego użytkownika w różnych witrynach. Następnie za pomocą interfejsu Private Aggregation API możesz wygenerować raport podsumowujący swój zasięg.
- Pomiar danych demograficznych: Producenci treści często chcą poznać dane demograficzne swoich z całego świata. Za pomocą pamięci współdzielonej możesz rejestrować dane demograficzne użytkowników w (np. z własnej witryny) i używaj zagregowanych danych w raportach na jej temat w wielu innych witrynach, np. zawierających treści umieszczone na stronach zewnętrznych.
- Pomiar częstotliwości K+: Czasami określa się ją jako „efektywną częstotliwość”. często istnieje minimalna liczba, wyświetlenia, zanim użytkownik rozpozna lub zapamięta określone treści (często na kontekst wyświetleń reklamy). Możliwość korzystania z pamięci współdzielonej do tworzenia raportów unikalnych użytkowników, którzy widzieli treści co najmniej K razy.
Angażuj odbiorców i dziel się opiniami
Propozycja wspólnego miejsca na dane jest w trakcie dyskusji i może ulec zmianie w przyszłości. Jeśli wypróbujesz ten interfejs API i chcesz przekazać nam swoją opinię, chętnie poznamy jego opinię.
- GitHub: przeczytaj propozycji, dokumentu dotyczącego zasięgu, przesyłania pytań i udziału w dyskusjach.
- Ogłoszenia dotyczące interfejsu Shared Storage API: dołącz do naszej listy adresowej lub dołącz do wcześniejszych ogłoszeń.
- Pomoc dla deweloperów: zadawaj pytania i dołączaj do dyskusji na Repozytorium pomocy dla deweloperów Piaskownicy prywatności.