Pomiar zasięgu wśród unikalnych użytkowników

Wielu twórców treści i reklamodawców chce wiedzieć, ilu unikalnych użytkowników zobaczyło ich treści. Używaj Shared Storage, aby rejestrować pierwsze wyświetlenie reklamy, osadzonego filmu lub publikacji przez użytkownika i zapobiegać duplikowaniu liczby wyświetleń tego samego użytkownika w różnych witrynach. Następnie możesz użyć interfejsu Private Aggregation API, aby wygenerować raport podsumowujący dotyczący zasięgu.

Shared Storage API to propozycja w ramach Piaskownicy prywatności dotycząca ogólnego przeznaczenia pamięci między witrynami, która obsługuje wiele możliwych przypadków użycia. Private Aggregation API to dane wyjściowe dostępne w Shared Storage, które umożliwiają agregowanie danych z różnych witryn. Aby dowiedzieć się więcej o metodach implementowania tych pomiarów, przeczytaj nasz dokument na temat zasięgu.

Wypróbuj pomiar zasięgu wśród unikalnych użytkowników

Aby eksperymentować z pomiarem unikalnego zasięgu za pomocą Shared Storage i Private Aggregation, upewnij się, że używasz Chrome w wersji M107 lub nowszej. Włącz wszystkie interfejsy API ochrony prywatności w reklamach w sekcji chrome://settings/adPrivacy.

Pamięć współdzieloną możesz też włączyć za pomocą flagi --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames w wierszu poleceń.

Eksperymentowanie z przykładowymi fragmentami kodu

Możesz śledzić, ilu unikalnych użytkowników wyświetliło Twoje treści w różnych witrynach. W tym przykładzie wymiar identyfikatora treści jest zakodowany w kluczu agregacji (zasobniku), a liczba jest używana jako wartość podlegająca agregacji. Raport podsumowujący będzie zawierać informacje takie jak „Około 391 użytkowników wyświetliło treść o identyfikatorze 123”.

W tym przykładzie:

  • unique-reach-measurement.js jest wczytywany za pomocą ramki i odpowiada za wczytywanie workletu pamięci współdzielonej.
  • unique-reach-measurement-worklet.js to element roboczy pamięci współdzielonej, który sprawdza flagę w pamięci współdzielonej i wysyła raport za pomocą interfejsu Private Aggregation API.

reach-measurement.js

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();

reach-measurement-worklet.js

// 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';

    // Don't 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 using 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 się i przesyłanie opinii

Pamiętaj, że propozycja interfejsu Shared Storage API jest w trakcie aktywnej dyskusji i opracowywania, dlatego może ulec zmianie.

Chętnie poznamy Twoją opinię o interfejsie Shared Storage API.