Supportressourcen für die Topics API im Web

Empfehlungen zur Fehlerbehebung und Supportressourcen für Topics im Web

Fehlerbehebung

Wenn Sie einen document.browsingTopics()-Aufruf oder eine fetch()-Anfrage mit dem Header Sec-Browsing-Topics starten, aber als Antwort ein leeres Array erhalten, können Sie eine Reihe von Schritten zur Fehlerbehebung ausführen, um die Ursache des Problems sowohl in Ihrer lokalen Entwicklungsumgebung als auch im Livesystem zu ermitteln.

Lokale Fehlerbehebung

Wenn Sie lokal testen, müssen Sie Chrome mit den erforderlichen Parametern ausführen.

  • Wenn Sie die Registrierung umgehen möchten, aktivieren Sie das Flag chrome://flags/#privacy-sandbox-enrollment-overrides und fügen Sie die URL der Website hinzu, die Topics aufruft.

  • Konfigurieren Sie die Topics API mithilfe der Feature-Flags für den Test. Mit diesen Flags können Sie Parameter wie die Epochendauer und die Anzahl der Top-Themen ändern, um Topics bequem zu testen. Sie können die folgenden empfohlenen Feature-Flags verwenden:

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

  • Bevor Sie Chrome mit Flags ausführen, müssen Sie alle anderen Chrome-Instanzen und ‑Prozesse schließen.

  • Prüfen Sie Folgendes:

    • Sie verwenden Chrome 101 oder höher.
    • Ihr Script hat die Topics API aufgerufen, um Themen zu beobachten. Beim Testen können Sie das Nutzerverhalten simulieren, indem Sie die Websites aufrufen, in die Ihr Script eingebettet ist. In der Demo finden Sie ein praktisches Beispiel.
    • Du verwendest keinen Adblocker oder eine ähnliche App oder Erweiterung.
    • Sie sind nicht im Inkognitomodus.
    • Ab chrome://settings/trackingProtection ist die Option Block all third-party cookies deaktiviert.

Live-Implementierung beheben

Wenn Sie die Topics API innerhalb der ersten Woche nach Beginn der Beobachtung eines Nutzers von einer Live-Anwendung aus aufrufen, ist ein leeres Ergebnis zu erwarten, da Ihre Anwendung möglicherweise noch keine Themen für einen Nutzer erfasst hat. Sie können Ihre Lösung anhand unserer Empfehlungen beheben.

  • Ihre Website muss für die Privacy Sandbox registriert sein.
  • Testen Sie Ihren Frontend-Code, um sicherzustellen, dass Ihr JavaScript wie erwartet funktioniert.
  • Testen Sie Ihr Backend, um die Themenergebnisse zu erhalten.
    • Achten Sie darauf, dass Datentypen und Backend-API-Parameter richtig konfiguriert sind.
    • Achten Sie darauf, dass Ihr Backend so konfiguriert ist, dass es angemessen skaliert werden kann.
  • Unsere Erfahrung zeigt, dass es mindestens drei Wochen dauert, bis Sie relevantere Themenergebnisse erhalten.
  • Nicht für alle Nutzer ist Topics aktiviert:
    • Nutzer können die Topics API explizit deaktivieren.
    • Auf den Seiten der Publisher können die Berechtigungsrichtlinien verwaltet und die Teilnahme ihrer Websites deaktiviert werden.
  • Fügen Sie dieser Umgebung Messwerte und Observabilität hinzu: Sie benötigen sie, um die ersten Ergebnisse zu analysieren. Beispiele für Messwerte:
    • Latenz von Anrufen.
    • HTTP-Fehler bei Themenaufrufen
  • Versuchen Sie, in den ersten drei Wochen möglichst wenige Änderungen an Ihrer Implementierung vorzunehmen.

Ressourcen