Topics API
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.
Warnung: Dieses Feature wird derzeit von zwei Browser-Anbietern abgelehnt. Siehe den Abschnitt Standards-Positionen unten für Einzelheiten zur Ablehnung.
Hinweis: Ein Einschreibungsprozess ist erforderlich, um die Topics API in Ihren Anwendungen zu nutzen. Siehe den Abschnitt Einschreibung für Details zu den Unterfunktionen, die durch die Einschreibung eingeschränkt werden.
Die Topics API bietet Entwicklern einen Mechanismus, um Anwendungsfälle wie interessenbasierte Werbung (IBA) zu implementieren, basierend auf Themen, die vom Browser gesammelt werden, während der Benutzer verschiedene Seiten besucht, anstatt vom Entwickler durch Verfolgung der Benutzerreise auf verschiedenen Websites mit Drittanbieter-Cookies gesammelt zu werden.
Konzepte und Nutzung
Ein typischer Mechanismus für Werbung im Web besteht darin, dass ein Benutzer Publisher-Seiten besucht, die eine Werbetechnologieplattform nutzen, um Anzeigen für die Produkte oder Dienstleistungen eines Werbetreibenden zu veröffentlichen. Der Publisher wird dafür bezahlt, die Anzeigen anzuzeigen, was zur Finanzierung ihrer Inhalte beiträgt und mehr Geschäft auf die Seiten der Werbetreibenden lenkt.
Dieser Prozess kann effektiver gestaltet werden, indem interessenbasierte Werbung (IBA) eingesetzt wird. Die Idee ist, dass den Benutzern bei ihrem Besuch der Publisher-Seiten eine personalisierte Auswahl von Anzeigen basierend auf ihren Interessen gezeigt wird. Ihre Interessen werden aus zuvor besuchten Seiten abgeleitet. In der Vergangenheit wurden Drittanbieter-Tracking-Cookies verwendet, um Informationen zu Benutzerinteressen zu sammeln, aber Browser stellen die Verfügbarkeit dieser Cookies für einen zunehmenden Anteil an Benutzern ein. Die Topics API bietet einen Teil des Weges zu diesem Ziel — einen Mechanismus zur Implementierung von IBA, der nicht von der Benutzerverfolgung abhängt.
Zunächst leitet der Browser die Interessen eines Benutzers aus den URLs der besuchten Seiten ab, die eingebettete Werbetechnologie <iframe>
s enthalten. Diese Interessen werden spezifischen Interessenthemen zugeordnet, und der Browser berechnet und speichert das Hauptthema des Benutzers (d.h. das Thema, dem seine Interessen am häufigsten zugeordnet wurden) am Ende jeder Epoche. Eine Epoche ist standardmäßig eine Woche. Das Hauptthema wird jede Woche aktualisiert, damit die Interessen aktuell bleiben und Benutzer keine Anzeigen zu Themen sehen, an denen sie nicht mehr interessiert sind.
Hinweis: Dieser Prozess findet nur auf Seiten statt, auf denen eine Topics API-Funktion verwendet wird (siehe Welche API-Funktionen ermöglichen die Topics API?).
Sobald der Browser ein oder mehrere Themen für einen Benutzer beobachtet hat, kann die Topics API diese abrufen und an eine Werbetechnologieplattform senden. Die Plattform kann diese Themen dann nutzen, um die Anzeigen, die sie dem Benutzer zeigt, zu personalisieren. Die API hilft, die Privatsphäre zu wahren, indem sie nur Themen an einen API-Aufrufer zurückgibt, die von ihm beobachtet wurden auf den vom aktuellen Benutzer besuchten Seiten.
Siehe Verwendung der Topics API für eine Erklärung, wie die API funktioniert.
Welche Themen gibt es?
Die verfügbaren Hauptthemen, die der Browser berechnen könnte, sind in einer öffentlich zugänglichen Taxonomie von Interessen gespeichert. Die anfängliche Taxonomie wurde von Chrome vorgeschlagen, mit der Absicht, dass es eine Ressource wird, die von vertrauenswürdigen Mitwirkenden des Ökosystems gepflegt wird. Die Taxonomie wurde menschlich kuratiert, um Kategorien auszuschließen, die allgemein als sensibel betrachtet werden, wie Ethnie oder sexuelle Orientierung.
Schnittstellen
Die Topics API hat keine eigenen spezifischen Schnittstellen.
Erweiterungen zu anderen Schnittstellen
Document.browsingTopics()
-
Gibt ein Versprechen zurück, das mit einem Array von Objekten erfüllt wird, die die Hauptthemen für den Benutzer darstellen, je eines aus jedem der letzten drei Epochen. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in der Themenberechnung verwendet werden kann.
fetch()
/Request()
, diebrowsingTopics
-Option-
Ein Boolean, der angibt, dass die ausgewählten Themen für den aktuellen Benutzer in einem
Sec-Browsing-Topics
-Header mit der zugehörigen Anfrage gesendet werden sollten. HTMLIFrameElement.browsingTopics
-
Eine boolesche Eigenschaft, die angibt, dass die ausgewählten Themen für den aktuellen Benutzer mit der Anfrage für die Quelle des zugehörigen
<iframe>
gesendet werden sollten. Dieses spiegelt den Wert des Inhaltsattributsbrowsingtopics
wider.
HTML-Elemente
HTTP-Header
Sec-Browsing-Topics
-
Sendet die ausgewählten Themen für den aktuellen Benutzer zusammen mit einer Anfrage, die von einer Werbetechnologieplattform verwendet werden, um eine personalisierte Anzeige auszuwählen, die angezeigt werden soll.
Observe-Browsing-Topics
-
Wird verwendet, um Themen von Interesse, die aus der URL der aufrufenden Seite abgeleitet wurden (d.h. die Seite, auf der das Werbetechnologie-
<iframe>
eingebettet ist), als in der Antwort auf eine von einem die Topics API ermöglichende Funktion generierte Anfrage beobachtet zu markieren. Der Browser wird diese Themen in der Folge verwenden, um Hauptthemen für den aktuellen Benutzer für zukünftige Epochen zu berechnen. Permissions-Policy
; diebrowsing-topics
-Richtlinie-
Steuert den Zugriff auf die Topics API. Wo eine Richtlinie die Nutzung der Topics API ausdrücklich untersagt, schlagen alle Versuche, die Methode
Document.browsingTopics()
aufzurufen oder eine Anfrage mit einemSec-Browsing-Topics
-Header zu senden, mit einemNotAllowedError
-DOMException
fehl.
Einschreibung
Um die Topics API auf Ihren Seiten zu verwenden, müssen Sie sie in einem Einschreibungsprozess für die Datenschutz-Sandbox angeben. Wenn Sie dies nicht tun, funktionieren die folgenden Unterfunktionen nicht:
- Das von der Methode
Document.browsingTopics()
zurückgegebene Versprechen wird mit einemNotAllowedError
-DOMException
abgelehnt. - Das Erstellen oder Modifizieren des
Sec-Browsing-Topics
-Headers schlägt stillschweigend fehl, und vorhandeneSec-Browsing-Topics
-Header werden gelöscht.
Beispiele
Für vollständige, funktionierende Beispiele siehe:
- Topics API-Demo: Demonstriert, wie
document.browsingTopics()
-Aufrufe verwendet werden können, um Themen zu beobachten und dann darauf zuzugreifen (siehe Quellcode). - Topics API-Header-Demo: Demonstriert, wie eine
fetch()
-Anfrage mit einemSec-Browsing-Topics
-Header verwendet werden kann, um Themen zu beobachten und dann darauf zuzugreifen (siehe Quellcode).
Spezifikationen
Dieses Feature ist Teil eines inoffiziellen Standards und wird im Topics API Unofficial Proposal Draft spezifiziert.
Standards-Positionen
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
browsingTopics |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Non-standard. Check cross-browser support before using.
Siehe auch
- Topics API auf developers.google.com (2023)
- Die Datenschutz-Sandbox auf developers.google.com (2023)