Wersje demonstracyjne Topics API

Eksperymentuj i dowiedz się, jak tematy są pobierane z nazw hostów, wymagają minimalnej konfiguracji.

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.

Wersja demonstracyjna interfejsu Topics API pokazuje, jak tematy są wnioskowane na podstawie nazw hostów. W witrynie demonstracyjnej, która wymaga bardzo prostej konfiguracji, możesz sprawdzić, jakie tematy są obserwowane.

Nasza prezentacja zawiera podgląd większości funkcji Topics API, który pozwoli Ci zapoznać się z jego implementacją.

Aby wypróbować model klasyfikacji Topics, możesz też uruchomić colab Topics.

Ten film pokazuje, jak działa ta wersja demonstracyjna.

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

Możesz wypróbować interfejs Topics API na 2 sposoby jako pojedynczy użytkownik. Musisz używać Chrome 101 lub nowszej wersji:

  • Włącz interfejs API na stronie Chrome chrome://flags/#privacy-sandbox-ads-apis:

    Włącz interfejs Topics API na stronie chrome://flags/#privacy-sandbox-ads-apis
    Strona chrome://flags/#privacy-sandbox-ads-apis, na której możesz włączyć lub wyłączyć interfejs API.

  • Uruchom Chrome z poziomu wiersza poleceń, używając tych flag:

    --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ń, takich jak długość epoki. Jeśli korzystasz z interfejsu Topics API przez uruchomienie Chrome z flagami wiersza poleceń, nie ustawiaj chrome://flags, ponieważ może to zastąpić ustawienia wiersza poleceń.

W artykule Uruchamianie Chromium z flagami wyjaśniamy, jak ustawić flagi w przypadku uruchamiania Chrome i innych przeglądarek opartych na Chromium z poziomu wiersza poleceń. Ta wersja demonstracyjna dotyczy tylko Google Chrome.

Wersja demonstracyjna nagłówków interfejsu Topics API

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

Otwórz nagłówek żądania Sec-Browsing-Topics

Zamiast korzystać z elementu document.browsingTopics() z elementu iframe do wyświetlania tematów dla użytkownika, wywołania interfejsu API mogą uzyskać dostęp do obserwowanych tematów z nagłówka żądania Sec-Browsing-Topics żądania pobierania(), które zawiera {browsingTopics: true} w parametrze opcji, lub z tego samego nagłówka żądania XHR, który ustawia atrybut deprecatedBrowsingTopics na 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 z listą tematów zaobserwowanych dla nazwy hosta adresu URL żądania: w tym przykładzie 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. Oznacza to, że 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. Przypomina to wywołanie metody document.browsingTopics() z elementu iframe, by wyświetlić tematy obserwowanych przez bieżącego użytkownika.

Nagłówek żądania jest wysyłany w odpowiedzi na żądanie, o ile ma odpowiednie zasady uprawnień, kontekst jest bezpieczny i ustawienia użytkownika na to zezwalają. W żądaniach nawigacyjnych nie są podawane tematy.

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, a także informacje o wersji każdego tematu.

Uwzględnianie nagłówka tematów w żądaniach XHR jest dostępne tylko tymczasowo. W przyszłości obsługa ta zostanie wycofana.

Oznacz tematy jako zaobserwowane w usłudze Observe-Browsing-Topics

Jeśli żądanie zawiera nagłówek Sec-Browsing-Topics, a odpowiedź na to żądanie zawiera nagłówek Observe-Browsing-Topics: ?1, tematy z nagłówka żądania będą oznaczane przez przeglądarkę jako obserwowane. Obserwowane tematy kwalifikują się do obliczeń przez interfejs Topics API. Mechanizm ten został zaprojektowany tak, aby pasował do funkcji udostępnianej przez interfejs JavaScript API z elementu iframe.

Poniższy zrzut ekranu przedstawia tematy zarejestrowane podczas odwiedzania witryn na stronie demonstracyjnej interfejsu API.

Strona demonstracyjna interfejsu Topics API w witrynie glitch.me
Prezentacja glitch.me testowania interfejsu API.

Ta lista zawiera witryny, które możesz odwiedzać z poziomu wersji demonstracyjnej, aby rejestrować interesujące Cię tematy. Jak widać, kategoria Sztuka i rozrywka/Rozrywka na zrzucie ekranu na zrzucie ekranu nie dotyczy żadnej z tych witryn, więc ten zarejestrowany temat został dodany jako 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ą prawdziwe, a które losowe. Ten zrzut ekranu przedstawia przykład z różnych sesji przeglądania.

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

Dalsze kroki

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

Angażuj i dziel się opiniami