Sec-Browsing-Topics header
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Warnung: Dieses Feature wird derzeit von zwei Browser-Anbietern abgelehnt. Details zur Ablehnung finden Sie im Abschnitt Standards positions.
Hinweis: Ein Anmeldeprozess ist erforderlich, um dieses Feature in Ihren Anwendungen zu nutzen.
Der HTTP Sec-Browsing-Topics Request-Header sendet die ausgewählten Themen des aktuellen Nutzers zusammen mit der zugehörigen Anfrage. Diese werden von einer Werbetechnologie-Plattform verwendet, um eine personalisierte Anzeige auszuwählen, die angezeigt werden soll.
Wenn die aufrufende Seite nicht die Topics API in einen erfolgreichen Privacy Sandbox Anmeldeprozess eingeschlossen hat, schlägt der Versuch, Sec-Browsing-Topics zu erstellen oder zu ändern, stillschweigend fehl, und jeder vorhandene Sec-Browsing-Topics-Header wird gelöscht.
Siehe Verwendung der Topics API für weitere Details.
| Header-Typ | Request-Header |
|---|---|
| Verbotener Request-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 ausgewählten Themen des aktuellen Nutzers für die letzten drei Epochen repräsentieren. Jedes Objekt enthält die folgenden Eigenschaften:
configVersion-
Ein String, der den Algorithmus (außer dem Model-Teil) identifiziert, der zur Berechnung des Themas verwendet wird.
modelVersion-
Ein String, der das Modell darstellt, das verwendet wird, um einen String (wie 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 eine Interessentaxonomie).
version-
Die
configVersion,modelVersionundtaxonomyVersion, verkettet mit Doppelpunkten (:) zwischen jedem.
Beispiele
Die genauen Eigenschaftswerte können je nach Browser-Implementierung variieren. Ein Beispiel-Header von Chrome könnte wie folgt aussehen:
Sec-Browsing-Topics: [{configVersion: "chrome.1", modelVersion: "1", taxonomyVersion: "1", topic: 43, version: "chrome.1:1:1"}]
Spezifikationen
Dieses Feature ist nicht Teil eines offiziellen Standards, obwohl es im Topics API Unofficial Proposal Draft beschrieben wird.