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

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.

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

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

Engage and share feedback

The Shared Storage proposal is under active discussion and subject to change in the future. If you try this API and have feedback, we'd love to hear it.