Wersje demonstracyjne Topics API

Eksperymentuj i dowiedz się, jak tematy są ustalane na podstawie nazw hostów, a konfiguracja jest minimalna.

Stan implementacji

  • Interfejs Topics API został właśnie ukończony w fazie dyskusji publicznych i jest obecnie dostępny dla 99% użytkowników, skalowalny w zakresie 100%.
  • Aby przesłać opinię o interfejsie Topics API, zgłoś problem za pomocą wyjaśnienia Topics lub weź udział w dyskusjach w grupie o ulepszaniu reklam internetowych. Wyjaśnienie zawiera kilka pytań otwartych, które nadal wymagają doprecyzowania.
  • Oś czasu Piaskownicy prywatności zawiera ramy czasowe wdrożenia interfejsu Topics API i innych ofert pakietowych Piaskownicy prywatności.
  • Topics API: najnowsze aktualizacje – szczegółowe informacje o zmianach i ulepszeniach interfejsu Topics API oraz ich implementacjach.

Demonstracja Topics API pokazuje, jak tematy są wnioskowane na podstawie nazw hostów. Możesz wyświetlić podgląd obserwowanych tematów, odwiedzając witrynę demonstracyjną, która wymaga bardzo niewielkiej konfiguracji.

Nasza wersja demonstracyjna zawiera podgląd większości funkcji interfejsu Topics API, aby umożliwić Ci zapoznanie się z jego implementacją.

Możesz też uruchomić colab w usłudze Topics, aby wypróbować model klasyfikacji Topics.

W filmie poniżej pokazujemy, jak działa wersja demonstracyjna.

Testowanie za pomocą strony chrome://flags lub flag funkcji

Interfejs Topics API możesz wypróbować jako pojedynczy użytkownik na 2 sposoby. Musisz korzystać z Chrome w wersji 101 lub nowszej:

  • Włącz wszystkie interfejsy Ad Privacy API w sekcji chrome://settings/adPrivacy.

  • Uruchom Chrome z poziomu wiersza poleceń z tymi flagami:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Prezentacja interfejsu Topics API

Prezentacja Topics pokazuje, jak używać dodatkowych flag do dostosowywania ustawień, na przykład długości epoki. Jeśli korzystasz z interfejsu Topics API, uruchamiając Chrome z flagami wiersza poleceń, nie ustawiaj zasady chrome://flags, ponieważ może ona zastąpić ustawienia wiersza poleceń.

Artykuł Uruchamianie Chromium z flagami zawiera wyjaśnienie, jak za pomocą wiersza poleceń ustawiać flagi podczas uruchamiania Chrome i innych przeglądarek opartych na Chromium. Jednak ta wersja demonstracyjna dotyczy tylko Google Chrome.

Demonstracja nagłówków Topics API

Prezentacja na stronie topics-fetch-demo.glitch.me pokazuje, jak używać nagłówków żądań i odpowiedzi fetch() do uzyskiwania dostępu do tematów i oznaczania ich jako obserwowanych.

Dostęp do nagłówka żądania Sec-Browsing-Topics

Zamiast używać elementu document.browsingTopics() z elementu iframe do wyświetlania tematów użytkownika, wywołujące interfejs API mogą uzyskać dostęp do obserwowanych tematów z nagłówka żądania Sec-Browsing-Topics w żądaniu pobierania(), które zawiera {browsingTopics: true} w parametrze opcji, lub z tego samego nagłówka żądania XHR, w którym atrybut deprecatedBrowsingTopics ma wartość true.

Na przykład:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

W przeglądarkach, które obsługują interfejs API, żądanie fetch() będzie zawierać nagłówek Sec-Browsing-Topics zawierający tematy zaobserwowane dla nazwy hosta adresu URL żądania. W tym przykładzie jest to topics-server.glitch.me.

Jeśli nie zaobserwowano żadnych tematów dla tej nazwy hosta i tego użytkownika, nagłówek zostanie uwzględniony, ale wartość będzie pusta. Inaczej mówiąc, nagłówek Sec-Browsing-Topics w żądaniu fetch() zawiera tylko tematy zaobserwowane w przeglądarce bieżącego użytkownika przez element wywołujący, którego źródło jest zgodne z nazwą hosta adresu URL żądania. Działa to tak samo, jakby wywoływanie funkcji document.browsingTopics() z elementu iframe w celu wyświetlenia zaobserwowanych tematów dla bieżącego użytkownika.

Nagłówek żądania jest wysyłany, jeśli tylko obowiązują odpowiednie zasady uprawnień, kontekst jest bezpieczny i pozwalają na to ustawienia użytkownika. W nagłówkach nie ma tematów żądań nawigacji.

Nagłówek żądania Topics wygląda tak:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

Ten przykład obejmuje 2 tematy z taksonomii tematów (186 i 265) wraz z informacjami o wersji każdego z nich.

Uwzględnienie nagłówka tematów w żądaniach XHR jest dostępne tylko tymczasowo i w przyszłości zostanie usunięte.

Oznacz tematy jako obserwowane przez użytkownika Observe-Browsing-Topics

Jeśli żądanie zawiera nagłówek Sec-Browsing-Topics, a odpowiedź zawiera nagłówek Observe-Browsing-Topics: ?1, tematy z nagłówka żądania zostaną oznaczone przez przeglądarkę jako obserwowane. Obserwowane tematy mogą zostać obliczone przy użyciu interfejsu Topics API. Mechanizm ten pasuje do funkcji zapewnianych przez interfejs API JavaScript w elemencie iframe.

Zrzut ekranu poniżej przedstawia tematy zarejestrowane podczas odwiedzania witryn na stronie demonstracyjnej interfejsu API.

Strona demonstracyjna interfejsu Topics API w glitch.me
Prezentacja glitch.me do wypróbowania interfejsu API.

Ta lista zawiera witryny, które możesz odwiedzać w ramach wersji demonstracyjnej, aby nagrywać interesujące tematy. Jak widać, kategoria Sztuka i rozrywka/Humor na zrzucie ekranu nie jest tematem jednej z tych stron, więc ten zarejestrowany temat został dodany jako możliwe 5% losowych tematów.

  • pets-animals-pets-cats.glitch.me
  • cats-cats-cats-cats.glitch.me
  • cats-pets-animals-pets.glitch.me
  • cats-feline-meow-purr-whiskers-pet.glitch.

Na karcie Stan tematów na stronie chrome://topics-internals możesz sprawdzić, które tematy są aktualne, a które losowe. Ten zrzut ekranu pokazuje przykład z różnych sesji przeglądania.

Karta Stan tematów zawiera informacje o obserwowanych tematach.
Karta Stan tematów z rzeczywistymi i losowymi tematami.

Dalsze kroki

Jeśli jesteś deweloperem technologii reklamowej, eksperymentuj i korzystaj z interfejsu Topics API. Więcej szczegółowych materiałów znajdziesz w przewodniku dla programistów.

Angażuj i dziel się opiniami