Uruchom Worklet Shared Storage, aby wybrać adres URL i wyrenderować go w zabezpieczonej ramce.
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 kontrola częstotliwości, z którego można korzystać do testów w Chrome Beta w wersji 104.0.5086.0 i nowszych.
Uruchom skrypt Worklet, aby wybrać adres URL z podanej listy na podstawie zapisanego a następnie wyrenderuj URL w ramce. Można tego użyć, aby wybrać nowych reklam lub innych treści po osiągnięciu limitu częstotliwości.
Testowanie wyboru kreacji według częstotliwości
Aby przetestować wybór kreacji według częstotliwości w przypadku pamięci współdzielonej i chronionych ramek, potwierdź, że:
korzystają z Chrome w wersji 104.0.5086.0 lub nowszej. 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
Aby wybrać i utworzyć nieprzezroczysty adres URL, zarejestruj moduł Worklet do odczytu udostępnionego i przechowywanie danych. Klasa Worklet otrzymuje listę maksymalnie 8 adresów URL, a następnie zwraca indeks wybranego adresu URL.
Gdy klient wywoła funkcję sharedStorage.selectURL()
, worklet
uruchamia i zwraca nieprzejrzysty adres URL, który jest renderowany w chronionej ramce.
Załóżmy, że chcesz wybrać do renderowania inną reklamę lub treści w zależności od tego, ile razy dany użytkownik już widział te treści. Możesz zliczać wyświetlenia treści użytkownikowi i zapisywać tę wartość w pamięci współdzielonej. Po zapisaniu wartość w pamięci współdzielonej staje się dostępna w różnych źródłach.
Następnie Worklet pamięci współdzielonej odczytuje wartości w pamięci współdzielonej i zwiększa licznik z każdym dodatkowym widokiem. Jeśli licznik nie osiągnie wstępnie zdefiniowanego limitu, zwrócona zostanie treść do wyrenderowania (indeks 1
). W przeciwnym razie zwracany jest domyślny adres URL (indeks 0
).
W tym przykładzie:
- Plik
creative-selection-by-frequencyjs
jest wczytywany za pomocą elementu iframe producenta treści lub reklamodawcy i odpowiada za to do wczytania Workletu pamięci współdzielonej i renderowania zwróconego nieprzezroczystego i wyświetlaj ją w osłoniętej ramce. creative-selection-by-frequency-worklet.js
to Worklet pamięci współdzielonej, który odczytuje częstotliwości w celu określenia, który adres URL jest zwracany w przypadku treści lub kreacji.
creative-selection-by-frequency.js
// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
{ url: `https://${contentProducerUrl}/default-content.html` },
{ url: `https://${contentProducerUrl}/example-content.html` },
];
async function injectAd() {
// Load the worklet module.
await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');
// Set the initial frequency count
window.sharedStorage.set('frequency-count', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose an ad based on the frequency count in shared storage.
const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectAd();
creative-selection-by-frequency-worklet.js
const FREQUENCY_LIMIT = 5;
class CreativeSelectionByFrequencyOperation {
async run(urls, data) {
// Read the current frequency limit in shared storage
const count = parseInt(await sharedStorage.get('frequency-count'));
// Check if the frequency limit has been reached.
if (count === FREQUENCY_LIMIT) {
console.log('Frequency limit has been reached, and the default content will be rendered.');
return 0;
}
// Set the new frequency count in shared storage
await sharedStorage.set('frequency-count', count + 1);
return 1;
}
}
// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);
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.