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 oferta pakietowa Piaskownicy prywatności do ogólnego przeznaczenia do przechowywania w różnych witrynach, która obsługuje wiele możliwych przypadków użycia. Private Aggregation API to dane wyjściowe dostępne w pamięci współdzielonej, które umożliwiają agregowanie danych z różnych witryn.

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: * Pole unique-reach-measurement.js jest ładowane 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 this.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.sendHistogramReport({ bucket, value });

    // Set the report submission status flag
    await this.sharedStorage.set(key, true);
  }
}

// Register the operation
register('reach-measurement', ReachMeasurementOperation);

Angażuj i dziel się opiniami

Oferta pamięci współdzielonej jest obecnie przedmiotem dyskusji i w przyszłości może ulec zmianie. Jeśli wypróbowujesz ten interfejs API i chcesz podzielić się opinią, chętnie poznamy Twoją opinię.