Wybierz kreację według częstotliwości

Uruchom Worklet Shared Storage, aby wybrać adres URL i wyrenderować go w zabezpieczonej ramce.

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ń. Jednym z przykładów jest kontrola częstotliwości, z którego można korzystać do testów w Chrome Beta w wersji 104.0.5086.0 i nowszych.

Uruchom skrypt Worklet, aby wybrać adres URL z podanej listy na podstawie zapisanego a następnie wyrenderuj URL w ramce. Można tego użyć, aby wybrać nowych reklam lub innych treści po osiągnięciu limitu częstotliwości.

Testowanie wyboru kreacji według częstotliwości

Aby przetestować wybór kreacji według częstotliwości w przypadku pamięci współdzielonej i chronionych ramek, potwierdź, że: korzystają z Chrome w wersji 104.0.5086.0 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

Aby wybrać i utworzyć nieprzezroczysty adres URL, zarejestruj moduł Worklet do odczytu udostępnionego i przechowywanie danych. Klasa Worklet otrzymuje listę maksymalnie 8 adresów URL, a następnie zwraca indeks wybranego adresu URL.

Gdy klient wywoła funkcję sharedStorage.selectURL(), worklet uruchamia i zwraca nieprzejrzysty adres URL, który jest renderowany w chronionej ramce.

Załóżmy, że chcesz wybrać do renderowania inną reklamę lub treści w zależności od tego, ile razy dany użytkownik już widział te treści. Możesz zliczać wyświetlenia treści użytkownikowi i zapisywać 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 Worklet pamięci współdzielonej odczytuje wartości w pamięci współdzielonej i zwiększa licznik z każdym dodatkowym widokiem. Jeśli licznik nie osiągnie wstępnie zdefiniowanego limitu, zwrócona zostanie treść do wyrenderowania (indeks 1). W przeciwnym razie zwracany jest domyślny adres URL (indeks 0).

W tym przykładzie:

  • Plik creative-selection-by-frequencyjs jest wczytywany za pomocą elementu iframe producenta treści lub reklamodawcy i odpowiada za to do wczytania Workletu pamięci współdzielonej i renderowania zwróconego nieprzezroczystego i wyświetlaj ją w osłoniętej ramce.
  • creative-selection-by-frequency-worklet.js to Worklet pamięci współdzielonej, który odczytuje częstotliwości w celu określenia, który adres URL jest zwracany w przypadku treści lub kreacji.

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

To tylko niektóre z możliwych zastosowań wspólnego miejsca na dane. Będziemy dodawać kolejne przykłady, gdy będziemy otrzymywać opinie i odkrywać nowe przypadki użycia.

Wybór treści

Wybieranie i wyświetlanie różnych treści na różnych stronach w ramkach wydzielonych na podstawie informacji zebranych w Shared Storage. W tych przypadkach bramą wyjściową jest wybór adresu URL.

  • Rotacja kreacji: przechowuj dane, takie jak identyfikator kreacji, liczba wyświetleń i interakcje użytkowników, aby określić, które kreacje widzą użytkownicy w różnych witrynach.
  • Testy A/B: możesz przypisać użytkownika do grupy eksperymentalnej, a potem zapisać tę grupę w usługach Shared Storage, aby umożliwić dostęp do niej w różnych witrynach.
  • Niestandardowe wrażenia użytkowników: udostępniaj niestandardowe treści i wezwania do działania na podstawie stanu rejestracji użytkownika lub innych stanów użytkownika.

generować raporty podsumowujące;

Gromadzenie informacji za pomocą usługi Shared Storage i generowanie raportu podsumowującego z dużą ilością szumu. Bramą wyjściową w tych przypadkach jest Private Aggregation API.

  • 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 obejrzało ich treści. Używaj pamięci współdzielonej, aby rejestrować, kiedy użytkownik zobaczył po raz pierwszy Twoją reklamę, osadzoną publikację lub film. Zapobiegnie to zliczaniu tego samego użytkownika w różnych witrynach. Następnie możesz użyć interfejsu Private Aggregation API, aby wygenerować raport podsumowujący zasięg.
  • Dane demograficzne: twórcy często chcą poznać dane demograficzne swoich odbiorców. Za pomocą pamięci współdzielonej możesz rejestrować dane demograficzne użytkowników w kontekście, w którym je masz, np. w witrynie własnej, a potem używać zbiorczego raportowania, aby tworzyć raporty na ich temat w wielu innych witrynach, np. w ramach treści umieszczonych w ramkach.
  • Pomiar częstotliwości K+: czasami określany jako „skuteczna częstotliwość”, często wymaga minimum liczby wyświetleń, zanim użytkownik rozpozna lub przypomni sobie określone treści (często w kontekście wyświetleń reklam). Korzystając z miejsca na dane współdzielonego, możesz tworzyć raporty dotyczące unikalnych użytkowników, którzy widzieli dany element treści co najmniej K razy.

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.

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?