Materiały pomocy dotyczące interfejsu Topics API w internecie

Znajdź rekomendacje dotyczące debugowania, rozwiązywania problemów i zasobów pomocy dla aplikacji Topics on the Web.

Rozwiązywanie problemów

Jeśli wywołasz funkcję document.browsingTopics() lub wysyłasz żądanie fetch() z ustawionym nagłówkiem Sec-Browsing-Topics, ale w odpowiedzi otrzymujesz pusty tablicę, możesz wykonać kilka czynności debugowania, aby zidentyfikować główną przyczynę problemu, zarówno w lokalnym środowisku programistycznym, jak i w systemie produkcyjnym.

Debugowanie lokalnie

Jeśli testujesz lokalnie, upewnij się, że używasz Chrome z wymaganymi parametrami.

  • Aby pominąć rejestrację, włącz flagę chrome://flags/#privacy-sandbox-enrollment-overrides i dodaj adres URL witryny, która wywołuje Tematy.

  • Skonfiguruj interfejs Topics API na potrzeby testowania za pomocą flag funkcji. Te flagi umożliwiają modyfikowanie parametrów takich jak czas trwania ery, liczba najpopularniejszych tematów i innych, dzięki czemu możesz wygodnie testować tematy. Możesz użyć tych zalecanych flag funkcji:

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

  • Zanim uruchomisz Chrome z flagami, zamknij wszystkie inne instancje i procesy Chrome.

  • Sprawdź, czy:

    • Używasz Chrome w wersji 101 lub nowszej.
    • Twój skrypt wywołał interfejs Topics API, aby obserwować tematy. Podczas testowania możesz symulować zachowanie użytkownika, odwiedzając witryny, w których osadzony jest skrypt. Praktyczny przykład znajdziesz w demonstracji.
    • Nie masz uruchomionego blokowania reklam ani podobnej aplikacji lub rozszerzenia.
    • Nie jesteś w trybie incognito.
    • Od chrome://settings/trackingProtection opcja Block all third-party cookies jest wyłączona.

Debugowanie implementacji na żywo

Jeśli wywołujesz interfejs Topics API z działającej aplikacji w pierwszym tygodniu obserwacji użytkownika, spodziewaj się pustego wyniku, ponieważ aplikacja może jeszcze nie obserwować tematów użytkownika. Możesz debugować swoje rozwiązanie zgodnie z naszymi zaleceniami.

  • Upewnij się, że Twoja witryna jest zarejestrowana w Piaskownicy prywatności.
  • Przetestuj kod po stronie klienta, aby się upewnić, że kod JavaScript działa zgodnie z oczekiwaniami.
  • Przetestuj backend, aby uzyskać wyniki dotyczące tematów.
    • Pamiętaj, aby sprawdzić, czy typy danych i parametry interfejsu API backendu są prawidłowo skonfigurowane.
    • Upewnij się, że backend jest skonfigurowany w sposób umożliwiający skalowanie.
  • Z naszych doświadczeń wynika, że aby uzyskać bardziej trafne wyniki, należy odczekać co najmniej 3 tygodnie.
  • Tematy nie będą dostępne dla wszystkich użytkowników:
    • Użytkownicy mogą wyraźnie wyłączyć interfejs Topics API.
    • Strony wydawcy mogą kontrolować zasady dotyczące uprawnień i wycofywać zgodę na korzystanie z ich witryn.
  • Dodaj do tego środowiska dane i funkcje obserwowalności: będą Ci potrzebne do przeanalizowania pierwszych wyników. Przykładowe dane:
    • Opóźnienia połączeń.
    • Błędy HTTP w wywołaniach interfejsu Topics.
  • W pierwszych 3 tygodniach staraj się ograniczać wprowadzanie zmian w wdrożeniu.

Zasoby