Interfejs Topics API: narzędzia do testowania i analizy

Poznaj narzędzia dostępne w Chrome, które umożliwiają wyświetlanie informacji o interfejsie Topics API, przypisywanie tematów i debugowanie implementacji.

Wyświetlanie informacji o interfejsie Topics API

Strona chrome://topics-internals będzie dostępna w Chrome na komputery po włączeniu interfejsu Topics API. Zostaną wyświetlone tematy dla bieżącego użytkownika, tematy ustalone na podstawie nazw hostów oraz informacje techniczne dotyczące implementacji interfejsu API. Na podstawie opinii programistów ulepszamy wygląd strony. Możesz wpływać na interfejs Topics API, przesyłając opinię w postaci błędu Chromium.

Wyświetlanie tematów zarejestrowanych w przeglądarce

Użytkownicy mogą przeglądać informacje o tematach obserwowanych w przeglądarce w obecnej i poprzedniej epoce, otwierając stronę chrome://topics-internals.

Strona chrome://topics-internals z wybranym panelem Stan tematów
Na stronie chrome://topics-internals panel Stan tematów zawiera identyfikatory tematów, przypisania do tematów losowych i rzeczywistych oraz wersje taksonomii i modeli.

Ten zrzut ekranu pokazuje, że ostatnio odwiedzone strony to topics-demo-cats.glitch.me i cats-cats-cats-cats.glitch.me. Powoduje to, że interfejs Topics API wybiera Pets i Cats jako 2 najważniejsze tematy w bieżącej epoce. Pozostałe 3 tematy zostały wybrane losowo, ponieważ historia przeglądania (w witrynach z odpowiadającymi tematami) jest niewystarczająca, aby można było przedstawić 5 tematów.

Kolumna Obserwowane przez domeny kontekstu (zahaszowane) zawiera zaszyfrowaną wartość nazwy hosta, w której przypadku zaobserwowano temat.

Wyświetlanie tematów wywnioskowanych na podstawie nazw hostów

Możesz też wyświetlić tematy wywnioskowane przez model klasyfikatora w przypadku co najmniej jednego hosta w chrome://topics-internals.

Strona chrome://topics-internals z wybranym panelem klasyfikatora.
Panel klasyfikacji stron chrome://topics-internals zawiera wybrane tematy, odwiedzone hosty oraz wersję i ścieżkę modelu.

Obecna implementacja Topics API określa tematy tylko na podstawie nazw hostów. a nie z żadnej innej części adresu URL.

Używaj tylko nazw hostów (bez protokołu i ścieżki) do wyświetlania tematów wywnioskowanych z klasyfikatora chrome://topics-internals. Jeśli spróbujesz dodać znak „/”, chrome://topics-internals wyświetli błąd w polu Host.

Wyświetlanie informacji o interfejsie Topics API

Informacje o implementacji i ustawieniach interfejsu Topics API, takie jak wersja taksonomii i czas trwania epoki, znajdziesz w tym artykule: chrome://topics-internals. Te wartości odzwierciedlają domyślne ustawienia interfejsu API lub parametry ustawione w wierszu poleceń. Może to pomóc w potwierdzeniu, że flagi wiersza poleceń działają zgodnie z oczekiwaniami.

W tym przykładzie pole time_period_per_epoch zostało ustawione na 15 sekund (domyślna wartość to 7 dni).

Strona chrome://topics-internals z wybranym panelem Funkcje i Parametry.
Panel chrome://topics-internals Funkcje i parametry zawiera informacje o włączonych funkcjach, czasie trwania epoki, liczbie epok używanych do obliczania tematów, wersji taksonomii i innych ustawieniach.

Parametry widoczne na zrzucie ekranu odpowiadają flagom, które można ustawić podczas uruchamiania Chrome z wiersza poleceń. Więcej informacji o sterowaniu interfejsem Topics API za pomocą flag Chrome znajdziesz w osobnej sekcji konfiguracji.

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

Colab

Uruchom Colab, aby dowiedzieć się, jak wczytać model TensorFlow Lite używany przez Chrome do wnioskowania tematów na podstawie nazw hostów. Instrukcje znajdziesz w opisie colab lub w filmie instruktażowym. Uwaga: ta usługa Colab korzysta ze starej wersji taksonomii.

Używanie interfejsu Topics API w witrynach z prebid.js

Jak wspomnieliśmy w wersji Prebid 7, społeczność aktywnie współpracowała z interfejsem Topics API za pomocą nowego modułu. Ten moduł został scalony w grudniu 2022 r. Przeczytaj dokumentację modułu Topics API w Prebid. Aby uzyskać więcej informacji o integracji, skontaktuj się z Prebid.js za pomocą dowolnego standardowego kanału oferowanego przez zespół Prebid.js.

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.