Dostosowywanie interfejsu pod kątem znanych klientów

Użyj workletu Shared Storage, aby zidentyfikować znanych klientów.

Interfejs Shared Storage API to propozycja Piaskownicy prywatności dotycząca ogólnego przeznaczenia, przechowywania między witrynami, która obsługuje wiele możliwych zastosowań. Jednym z takich przykładów jest identyfikowanie znanych klientów, które można testować w Chrome w wersji 104.0.5086.0 lub nowszej.

Możesz zapisać w Shared Storage informacje o tym, czy użytkownik zarejestrował się w Twojej witrynie, a potem wyrenderować osobny element na podstawie zapisanego stanu użytkownika (czy jest on „znanym” klientem).

Ustawianie znanych klientów

Aby eksperymentować z identyfikacją znanych klientów w Shared Storage, sprawdź, czy używasz Chrome w wersji 104.0.5086.0 lub nowszej. Włącz wszystkie interfejsy API dotyczące prywatności w reklamach w sekcji chrome://settings/adPrivacy.

Możesz też włączyć współdzielone miejsce na dane, używając parametru --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames w wierszu poleceń.

Eksperymentowanie z przykładowymi fragmentami kodu

Możesz renderować inny element w zależności od tego, czy użytkownik był widziany w innej witrynie. Na przykład dostawca płatności może wyświetlić przycisk „Zarejestruj się” lub „Kup teraz” w zależności od tego, czy użytkownik zarejestrował się w witrynie dostawcy płatności. Współdzielone miejsce na dane może służyć do określania stanu użytkownika i dostosowywania jego wrażeń na podstawie tego stanu.

W tym przykładzie:

  • known-customer.js jest umieszczony w ramce. Ten skrypt ustawia opcje, które przyciski powinny być wyświetlane w witrynie: „Zarejestruj się” lub „Kup teraz”.
  • known-customer-worklet.js to element roboczy współdzielonego miejsca na dane, który określa, czy użytkownik jest znany. Jeśli użytkownik jest znany, informacje są zwracane. Jeśli użytkownik jest nieznany, zwracane są informacje, które umożliwiają wyświetlenie przycisku „Zarejestruj się”, a użytkownik jest oznaczany jako znany na przyszłość.

known-customer.js

// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
  { url: `https://${advertiserUrl}/ads/register-button.html` },
  { url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];

async function injectButton() {
  // Load the worklet module
  await window.sharedStorage.worklet.addModule('known-customer-worklet.js');

  // Set the initial status to unknown ('0' is unknown and '1' is known)
  window.sharedStorage.set('known-customer', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose the button based on the user status
  const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('button-slot').src = fencedFrameConfig;
}

injectButton();

known-customer-worklet.js

class SelectURLOperation {
  async run(urls) {
    const knownCustomer = await sharedStorage.get('known-customer');

    // '0' is unknown and '1' is known
    return parseInt(knownCustomer);
  }
}

register('known-customer', SelectURLOperation);

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 użytkowników i przesyłanie opinii

Pamiętaj, że interfejs Select URL API jest obecnie przedmiotem dyskusji i jest w trakcie opracowywania, dlatego może ulec zmianie.

Chętnie poznamy Twoją opinię na temat interfejsu Select URL API.

Trzymaj rękę na pulsie

  • Lista mailingowa: zasubskrybuj naszą listę mailingową, aby otrzymywać najnowsze informacje i komunikaty dotyczące interfejsów Select URL i Shared Storage API.

Potrzebujesz pomocy?