Wybierz kreację według częstotliwości

Uruchom worklet Shared Storage, aby wybrać adres URL i wyrenderować go w ramce ograniczonej.

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. Przykładem jest kontrola częstotliwości, która jest dostępna do testowania w Chrome Beta w wersji 104.0.5086.0 i nowszej.

Uruchom skrypt workletu, aby wybrać adres URL z podanej listy na podstawie przechowywanych danych, a następnie wyrenderować ten adres URL w ramce ograniczonej. Możesz go użyć do wybierania nowych reklam lub innych treści po osiągnięciu limitu częstotliwości.

Testowanie wyboru kreacji według częstotliwości

Aby przetestować wybieranie kreacji według częstotliwości za pomocą pamięci współdzielonej i ramki ograniczonej, upewnij się, że używasz Chrome w wersji 104.0.5086.0 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

Aby wybrać i utworzyć nieprzejrzysty adres URL, zarejestruj moduł worklet, który będzie odczytywać dane z pamięci współdzielonej. Klasa workletu otrzymuje listę maksymalnie 8 adresów URL, a następnie zwraca indeks wybranego adresu URL.

Gdy klient wywoła funkcję sharedStorage.selectURL(), element roboczy zostanie wykonany i zwróci nieprzezroczysty adres URL, który ma być renderowany w ramce ograniczonej.

Załóżmy, że chcesz wybrać inną reklamę lub treść do wyświetlenia na podstawie częstotliwości, z jaką użytkownik widział ją wcześniej. Możesz zliczać, ile razy użytkownik zobaczył treści, i przechowywać 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 moduł roboczy pamięci współdzielonej odczytuje wartości w pamięci współdzielonej i zwiększa licznik z każdym dodatkowym wyświetleniem. Jeśli liczba nie osiągnęła wcześniej zdefiniowanego limitu, zwracana jest treść, którą chcesz wyświetlić (indeks 1). W przeciwnym razie zwracany jest domyślny adres URL (indeks 0).

W tym przykładzie:

  • creative-selection-by-frequencyjs jest wczytywany za pomocą elementu iframe producenta treści lub reklamodawcy i odpowiada za wczytywanie workletu pamięci współdzielonej oraz renderowanie zwróconego nieprzezroczystego źródła w ramce ograniczonej.
  • creative-selection-by-frequency-worklet.js to proces roboczy pamięci współdzielonej, który odczytuje liczbę wyświetleń, aby określić, który adres URL ma zostać zwrócony w przypadku treści lub kreacji reklamy.

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

W tej sekcji znajdziesz wszystkie dostępne przypadki użycia interfejsu Select URL API. Będziemy dodawać kolejne przykłady, gdy będziemy otrzymywać opinie i odkrywać nowe przypadki testowe.

Angażowanie się i przesyłanie opinii

Pamiętaj, że propozycja interfejsu Select URL API jest obecnie przedmiotem dyskusji i prac rozwojowych, a jej treść może ulec zmianie.

Chętnie poznamy Twoją opinię o interfejsie Select URL API.