Wielu producentów treści i reklamodawców chce wiedzieć, ile unikalnych osób zobaczyło ich treści. Dzięki tej funkcji możesz rejestrować pierwsze wyświetlenie reklamy, umieszczonego filmu lub publikacji i zapobiegać duplikowaniu w przypadku różnych witryn tego samego użytkownika. Następnie za pomocą interfejsu Private Aggregation API możesz wygenerować raport podsumowujący swój zasięg.
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ń. Private Aggregation API to dane wyjściowe dostępne w pamięci współdzielonej, które umożliwiają agregowanie danych z różnych witryn. Więcej informacji o metodach wdrażania tych pomiarów znajdziesz w naszym raporcie dotyczącym zasięgu.
Wypróbuj pomiar zasięgu wśród unikalnych użytkowników
Aby eksperymentować z pomiarem zasięgu wśród unikalnych użytkowników za pomocą pamięci współdzielonej i agregacji prywatnej, sprawdź, czy używasz Chrome w wersji M107 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
Możesz śledzić liczbę unikalnych użytkowników, którzy zobaczyli Twoje treści w różnych witrynach. W tym przykładzie wymiar identyfikatora treści jest zakodowany w kluczu agregacji (zasobnik), a liczba jest używana jako wartość agregowana. Będzie on zawierał takie informacje, jak „Ok. 391 użytkowników widziało identyfikator treści 123”.
W tym przykładzie:
* unique-reach-measurement.js
jest ładowany za pomocą ramki i odpowiada za wczytanie Workletu pamięci współdzielonej.
* unique-reach-measurement-worklet.js
to Worklet pamięci współdzielonej, który sprawdza flagę w pamięci współdzielonej i wysyła raport za pomocą interfejsu Private Aggregation API.
async function measureUniqueReach() {
// Load the Shared Storage worklet
await window.sharedStorage.worklet.addModule('reach-measurement-worklet.js');
// Run the reach measurement operation
await window.sharedStorage.run('reach-measurement', { data: { contentId: '1234' } });
}
measureUniqueReach();
// Learn more about noise and scaling from the Private Aggregation fundamentals
// documentation on Chrome blog
const SCALE_FACTOR = 65536;
function convertContentIdToBucket(contentId) {
return BigInt(contentId);
}
class ReachMeasurementOperation {
async run(data) {
const { contentId } = data;
// Read from Shared Storage
const key = 'has-reported-content';
const hasReportedContent = (await sharedStorage.get(key)) === 'true';
// Do not report if a report has been sent already
if (hasReportedContent) {
return;
}
// Generate the aggregation key and the aggregatable value
const bucket = convertContentIdToBucket(contentId);
const value = 1 * SCALE_FACTOR;
// Send an aggregatable report via the Private Aggregation API
privateAggregation.contributeToHistogram({ bucket, value });
// Set the report submission status flag
await sharedStorage.set(key, true);
}
}
// Register the operation
register('reach-measurement', ReachMeasurementOperation);
Angażowanie użytkowników i przesyłanie opinii
Pamiętaj, że propozycja interfejsu Shared Storage API jest obecnie przedmiotem dyskusji i jest w fazie rozwoju, dlatego może ulec zmianie.
Chętnie poznamy Twoją opinię na temat interfejsu Shared Storage API.
- Proposal (Propozycja): zapoznaj się ze szczegółami oferty.
- Dyskusja: dołącz do trwającej dyskusji, aby zadawać pytania i dzielić się swoimi spostrzeżeniami.
Trzymaj rękę na pulsie
- Lista mailingowa: zasubskrybuj naszą listę mailingową, aby otrzymywać najnowsze informacje i ogłoszenia dotyczące interfejsu Storage API.
Potrzebujesz pomocy?
- Pomoc dla deweloperów: możesz kontaktować się z innymi deweloperami i uzyskiwać odpowiedzi na swoje pytania w repozytorium pomocy dla deweloperów Piaskownicy prywatności.