Topics API
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.
Warnung: Dieses Feature wird derzeit von zwei Browseranbietern abgelehnt. Details zur Ablehnung finden Sie im Abschnitt Standards positionen unten.
Hinweis: Ein Registrierungsprozess ist erforderlich, um die Topics-API in Ihren Anwendungen zu verwenden. Details, welche Teilfunktionen durch die Registrierung gesperrt sind, finden Sie im Abschnitt Registrierung.
Die Topics API bietet eine Möglichkeit für Entwickler, 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 gesammelt zu werden, indem die Reise des Benutzers über verschiedene Websites mit Drittanbieter-Cookies verfolgt wird.
Konzepte und Verwendung
Ein typischer Mechanismus zur Werbung im Web besteht darin, dass ein Benutzer Verlag-Seiten besucht, die eine Werbetechnologie-Plattform (Ad Tech) verwenden, um Anzeigen für die Produkte oder Dienstleistungen eines Werbetreibenden zu veröffentlichen. Der Verlag wird für die Anzeige der Anzeigen bezahlt, was hilft, ihre Inhalte zu finanzieren, und mehr Geschäft zu den Werbetreibenden-Websites bringt.
Der oben beschriebene Prozess kann durch interessenbasierte Werbung (IBA) effektiver gestaltet werden. Die Idee ist, dass Benutzern, wenn sie die Verlagsseiten besuchen, eine personalisierte Auswahl an Anzeigen basierend auf ihren Interessen serviert wird. Ihre Interessen werden von Websites abgeleitet, die sie zuvor besucht haben. In der Vergangenheit wurden Drittanbieter-Cookies verwendet, um Informationen zu Benutzerinteressen zu sammeln, aber Browser schränken die Verfügbarkeit von Drittanbieter-Cookies für eine zunehmende Anzahl von Benutzern immer mehr ein. Die Topics API bietet einen Teil des Weges zu diesem Ziel — einen Mechanismus zur Implementierung von IBA, der nicht auf Benutzerverfolgung angewiesen ist.
Zunächst leitet der Browser die Interessen eines Benutzers aus den URLs der Websites ab, die sie besuchen und in denen Ad-Tech-<iframe>
s eingebettet sind. Diese Interessen werden spezifischen Interessenthemen zugeordnet, und der Browser berechnet und zeichnet das Hauptthema der Benutzer (d. h. das Thema, dem ihre Interessen am häufigsten zugeordnet wurden) am Ende jeder Epoche auf. Eine Epoche dauert standardmäßig eine Woche. Das Hauptthema wird jede Woche aktualisiert, damit Interessen aktuell bleiben und Benutzer keine Anzeigen für Themen sehen, an denen sie nicht mehr interessiert sind.
Hinweis: Dieser Prozess findet nur auf Websites statt, auf denen ein Feature der Topics API verwendet wird (siehe Welche API-Funktionen aktivieren 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 Ad-Tech-Plattform senden. Die Plattform kann dann diese Themen verwenden, um die Anzeigen zu personalisieren, die sie dem Benutzer serviert. Die API trägt dazu bei, die Privatsphäre zu schützen, indem nur Themen an einen API-Aufrufer zurückgegeben werden, die von ihm auf vom aktuellen Benutzer besuchten Seiten beobachtet wurden.
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 Interessen-Taxonomie gespeichert. Die ursprüngliche Taxonomie wurde von Chrome vorgeschlagen, mit dem Ziel, dass sie eine Ressource wird, die von vertrauenswürdigen Ökosystem-Beitragenden gepflegt wird. Die Taxonomie wurde menschlich kuratiert, um Kategorien auszuschließen, die allgemein als sensibel betrachtet werden, wie ethnische Zugehörigkeit 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, eins aus jeder der letzten drei Epochen. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als vom Anrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in der Themenberechnung verwendet werden kann.
fetch()
/Request()
, die OptionbrowsingTopics
-
Ein boolescher Wert, 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 sollen. Dies spiegelt den Attributwertbrowsingtopics
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 Ad Tech-Plattform verwendet werden, um eine personalisierte Anzeige auszuwählen, die angezeigt werden soll.
Observe-Browsing-Topics
-
Wird verwendet, um Interessenthemen, die aus der URL einer aufrufenden Seite abgeleitet wurden (d. h. die Seite, in der das Ad Tech-
<iframe>
eingebettet ist), in der Antwort auf eine von einer Funktion, die die Topics API ermöglicht erstellte Anfrage, als beobachtet zu markieren. Der Browser wird diese Themen anschließend verwenden, um Hauptthemen für den aktuellen Benutzer für zukünftige Epochen zu berechnen. Permissions-Policy
; die Richtliniebrowsing-topics
-
Steuert den Zugriff auf die Topics API. Wenn eine Richtlinie die Verwendung der Topics API ausdrücklich verweigert, schlagen alle Versuche, die Methode
Document.browsingTopics()
aufzurufen oder eine Anfrage mit einemSec-Browsing-Topics
-Header zu senden, mit einemNotAllowedError
DOMException
fehl.
Registrierung
Um die Topics API auf Ihren Websites zu verwenden, müssen Sie sie in einem Anmeldeverfahren für die Datenschutzzone angeben. Wenn Sie dies nicht tun, funktionieren die folgenden Teilfunktionen nicht:
- Das von der Methode
Document.browsingTopics()
zurückgegebene Promise wird mit einemNotAllowedError
DOMException
abgelehnt. - Das Erstellen oder Ändern des
Sec-Browsing-Topics
-Headers wird stillschweigend fehlschlagen, und ein vorhandenerSec-Browsing-Topics
-Header wird gelöscht.
Beispiele
Für vollständige funktionierende Beispiele siehe:
- Topics API-Demo: Zeigt, wie
document.browsingTopics()
-Aufrufe verwendet werden können, um Themen zu beobachten und darauf zuzugreifen (siehe Quellcode). - Topics API-Header-Demo: Zeigt, wie eine
fetch()
-Anfrage mit einemSec-Browsing-Topics
-Header verwendet werden kann, um Themen zu beobachten und darauf zuzugreifen (siehe Quellcode).
Spezifikationen
Dieses Feature ist kein Teil eines offiziellen Standards, obwohl es im Topics API Unofficial Proposal Draft spezifiziert ist.
Standards positionen
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Topics API auf developers.google.com (2023)
- The Privacy Sandbox auf developers.google.com (2023)