Sec-Browsing-Topics header
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates. Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the topics API.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Warnung: Diese Funktion wird derzeit von zwei Browseranbietern abgelehnt. Siehe den Abschnitt Standards Positionen für Details zur Ablehnung.
Hinweis: Ein Anmeldeprozess ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.
Der HTTP Sec-Browsing-Topics Anforderungs-Header sendet die ausgewählten Themen des aktuellen Nutzers zusammen mit der zugehörigen Anforderung. Diese werden von einer Werbetechnologie-Plattform verwendet, um eine personalisierte Werbung auszuwählen, die angezeigt werden soll.
Wenn die aufrufende Seite die Topics API nicht in einem erfolgreichen Anmeldeprozess der Privacy Sandbox enthalten hat, schlägt ein Versuch zur Erstellung oder Änderung von Sec-Browsing-Topics stillschweigend fehl und ein vorhandener Sec-Browsing-Topics-Header wird gelöscht.
| Header-Typ | Anforderungs-Header |
|---|---|
| Verbotener Anforderungs-Header | Ja (Sec--Präfix) |
Syntax
Sec-Browsing-Topics: <array-of-observed-topics>
Direktiven
Ein JSON-Objekt, das ein Array von bis zu drei Objekten darstellt, die die vom aktuellen Nutzer ausgewählten Themen für die letzten drei Epochen repräsentieren. Jedes Objekt enthält die folgenden Eigenschaften:
configVersion-
Ein String, der den Algorithmus (außer dem Modellteil) identifiziert, der zur Berechnung des Themas verwendet wird.
modelVersion-
Ein String, der das Modell repräsentiert, das verwendet wird, um einen String (wie zum Beispiel den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersion-
Ein String, der die verwendete Taxonomieversion darstellt.
topic-
Eine Zahl, die die ID des Themas darstellt, die vom Browser verwendet werden kann, um das Thema aus der Taxonomie abzurufen (siehe ein Beispiel für die Taxonomie von Interessen).
version-
Die
configVersion,modelVersionundtaxonomyVersion, mit Doppelpunkten (:) zwischen jeweils.
Beispiele
Die genauen Eigenschaftswerte können je nach Browser-Implementierung variieren. Ein Beispiel-Header aus Chrome könnte folgendermaßen aussehen:
Sec-Browsing-Topics: [{configVersion: "chrome.1", modelVersion: "1", taxonomyVersion: "1", topic: 43, version: "chrome.1:1:1"}]
Spezifikationen
Diese Funktion ist kein Teil eines offiziellen Standards, obwohl sie im Topics API Unofficial Proposal Draft spezifiziert ist.