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 Browseranbietern abgelehnt. Details zur Ablehnung finden Sie im Abschnitt Standards positions unten.
Hinweis: Ein Anmeldeverfahren ist erforderlich, um die Topics API in Ihren Anwendungen zu verwenden. Siehe den Abschnitt Enrollment für Details, welche Unterfunktionen durch die Anmeldung eingeschränkt sind.
Die Topics API bietet Entwicklern einen Mechanismus zur Implementierung von Anwendungsfällen wie interessenbasierter Werbung (IBA), beruhend auf Themen, die vom Browser gesammelt werden, während der Benutzer unterschiedliche Seiten besucht, anstatt vom Entwickler gesammelt zu werden, indem die Reise des Benutzers über verschiedene Seiten mit Drittanbieter-Cookies verfolgt wird.
Konzepte und Nutzung
Ein typischer Mechanismus für Werbung im Web besteht darin, dass ein Benutzer Publisher-Seiten besucht, die eine Werbetechnologie-Plattform (Ad Tech) verwenden, um Anzeigen für die Produkte oder Dienstleistungen eines Werbetreibenden zu veröffentlichen. Der Publisher wird bezahlt, um die Anzeigen anzuzeigen, was hilft, seine Inhalte zu finanzieren, und mehr Geschäft wird auf die Websites der Werbetreibenden gelenkt.
Dieser Prozess kann durch interessenbasierte Werbung (IBA) effektiver gestaltet werden. Die Idee ist, dass bei Besuchen der Publisher-Seiten dem Benutzer eine personalisierte Auswahl von Anzeigen basierend auf seinen Interessen präsentiert wird. Ihre Interessen werden aus den zuvor besuchten Seiten abgeleitet. In der Vergangenheit wurden Drittanbieter-Tracking-Cookies verwendet, um Informationen über die Interessen der Benutzer zu sammeln, aber Browser reduzieren zunehmend die Verfügbarkeit von Drittanbieter-Cookies für einen wachsenden Anteil der Benutzer. Die Topics API bietet einen Teil des Weges zu diesem Ziel — einen Mechanismus zur Implementierung von IBA, der nicht vom Benutzer-Tracking abhängig ist.
Zunächst leitet der Browser die Interessen eines Benutzers aus den URLs von Seiten ab, die eingebettete Ad Tech <iframe>
s haben. Diese Interessen werden bestimmten Interessenthemen zugeordnet, und der Browser berechnet und speichert das Hauptthema der Benutzer (d.h. das Thema, das ihren Interessen am häufigsten zugeordnet wurde) am Ende jedes Epoch. Eine Epoche ist standardmäßig eine Woche. Das Hauptthema wird jede Woche aktualisiert, damit die Interessen aktuell bleiben und die Benutzer keine Anzeigen zu Themen sehen, an denen sie nicht mehr interessiert sind.
Hinweis: Dieser Prozess geschieht nur auf Seiten, 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 Ad Tech-Plattform senden. Die Plattform kann diese Themen dann verwenden, um die Anzeigen, die sie dem Benutzer präsentieren, zu personalisieren. Die API trägt dazu bei, die Privatsphäre zu schützen, indem nur Themen an einen API-Aufrufer zurückgegeben werden, die von ihnen auf Seiten, die vom aktuellen Benutzer besucht wurden, 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 einem öffentlich verfügbaren Taxonomie der Interessen gespeichert. Die anfängliche Taxonomie wurde von Chrome vorgeschlagen, mit der Absicht, dass sie eine von vertrauenswürdigen Ökosystemteilnehmern gepflegte Ressource wird. Die Taxonomie wurde menschlich kuratiert, um Kategorien auszuschließen, die allgemein als sensibel angesehen 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 des Benutzers darstellen, je eines aus den letzten drei Epochen. Standardmäßig bewirkt die Methode auch, 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 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 sollen. HTMLIFrameElement.browsingTopics
-
Eine boolesche Eigenschaft, die angibt, dass die ausgewählten Themen für den aktuellen Benutzer mit der Anforderung für die Quelle des zugehörigen
<iframe>
gesendet werden sollen. Dies spiegelt den Wert desbrowsingtopics
-Inhaltsattributs wider.
HTML-Elemente
HTTP-Header
Sec-Browsing-Topics
-
Sendet die ausgewählten Themen für den aktuellen Nutzer zusammen mit einer Anfrage, die von einer Ad Tech-Plattform verwendet werden, um eine personalisierte Anzeige auszuwählen.
Observe-Browsing-Topics
-
Wird verwendet, um Themen von Interesse, die von der URL der aufrufenden Seite abgeleitet wurden (d.h. die Seite, auf der das Ad Tech
<iframe>
eingebettet ist), als in der Antwort auf eine durch ein Feature, das die Topics API ermöglicht generierte Anfrage beobachtet zu markieren. Der Browser wird diese Themen anschließend verwenden, um die Hauptthemen für den aktuellen Benutzer für zukünftige Epochen zu berechnen. Permissions-Policy
; diebrowsing-topics
-Richtlinie-
Kontrolliert den Zugriff auf die Topics API. Wenn eine Richtlinie die Verwendung der Topics API ausdrücklich verbietet, 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 Seiten zu verwenden, müssen Sie sie in einem Privacy Sandbox Registrierungsvorgang angeben. Wenn Sie dies nicht tun, funktionieren die folgenden Unterfunktionen nicht:
- Das Versprechen, das von der Methode
Document.browsingTopics()
zurückgegeben wird, wird mit einemNotAllowedError
DOMException
abgelehnt. - Das Erstellen oder Ändern des
Sec-Browsing-Topics
-Headers schlägt stillschweigend fehl, und alle vorhandenenSec-Browsing-Topics
-Header werden 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: Demonstriert, wie ein
fetch()
-Anforderung mit einemSec-Browsing-Topics
-Header verwendet werden kann, um Themen zu beobachten und darauf zuzugreifen (siehe Quellcode).
Spezifikationen
Dieses Feature ist nicht Teil eines offiziellen Standards, obwohl es im Topics API Unofficial Proposal Draft spezifiziert ist.
Standards Positionen
Browser-Kompatibilität
Siehe auch
- Topics API auf privacysandbox.google.com (2023)
- Die Privacy Sandbox auf privacysandbox.google.com (2023)