Sec-Browsing-Topics header
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. 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. Weitere Informationen zu den Einwänden finden Sie im Abschnitt Standards positions.
Hinweis: Ein Registrierungsprozess ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.
Der HTTP Sec-Browsing-Topics Request-Header sendet die ausgewählten Themen für den aktuellen Benutzer zusammen mit der zugehörigen Anfrage, die von einer Werbetechnologieplattform verwendet werden, um eine personalisierte Anzeige auszuwählen.
Wenn die aufrufende Seite die Topics API nicht in einem erfolgreichen Privacy-Sandbox-Registrierungsprozess enthalten hat, schlägt der Versuch, Sec-Browsing-Topics zu erstellen oder zu ändern, stillschweigend fehl und ein vorhandener Sec-Browsing-Topics-Header wird gelöscht.
Weitere Details finden Sie unter Using the Topics API.
| 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 mit bis zu drei Objekten darstellt, die die vom aktuellen Benutzer ausgewählten Themen für die letzten drei Epochen repräsentieren. Jedes Objekt enthält folgende Eigenschaften:
configVersion-
Eine Zeichenfolge, die den Algorithmus (außer dem Modellteil) identifiziert, der zur Berechnung des Themas verwendet wird.
modelVersion-
Eine Zeichenfolge, die das Modell darstellt, das verwendet wird, um eine Zeichenfolge (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersion-
Eine Zeichenfolge, die die verwendete Taxonomieversion darstellt.
topic-
Eine Zahl, die die ID des Themas darstellt und vom Browser verwendet werden kann, um das Thema aus der Taxonomie abzurufen (siehe ein Beispiel für eine Taxonomie der Interessen).
version-
Die
configVersion,modelVersionundtaxonomyVersion, mit Doppelpunkten (:) zwischen jedem zusammengefügt.
Beispiele
Die genauen Eigenschaftswerte können je nach Browser-Implementierung variieren. Ein Beispiel-Header von 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.