Sec-Browsing-Topics
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: Diese Funktion wird derzeit von zwei Browser-Anbietern abgelehnt. Siehe den Abschnitt Standards-Positionen für Details zur Ablehnung.
Hinweis: Ein Registrierungsprozess ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.
Der HTTP Sec-Browsing-Topics
Anforderungs-Header sendet die ausgewählten Themen des aktuellen Benutzers zusammen mit der zugehörigen Anforderung, die von einer Werbetechnik-Plattform verwendet werden, um eine personalisierte Anzeige auszuwählen, die angezeigt werden soll.
Wenn die aufrufende Seite nicht die Topics-API in einem erfolgreichen Privacy-Sandbox-Registrierungsprozess enthalten hat, schlägt der Versuch, Sec-Browsing-Topics
zu erstellen oder zu ändern, ohne Meldung fehl, und ein vorhandener Sec-Browsing-Topics
-Header wird gelöscht.
Siehe Using the Topics API für mehr Details.
Header-Typ | Anforderungs-Header |
---|---|
Verbotener Header-Name | 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 Benutzers für die letzten drei Zeiträume repräsentieren. Jedes Objekt enthält die folgenden Eigenschaften:
configVersion
-
Eine Zeichenkette, die den Algorithmus (außer dem Modellteil) identifiziert, der zur Berechnung des Themas verwendet wird.
modelVersion
-
Eine Zeichenkette, die das Modell darstellt, das verwendet wird, um eine Zeichenfolge (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersion
-
Eine Zeichenkette, die die verwendete Taxonomieversion darstellt.
topic
-
Eine Nummer, 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 Taxonomie der Interessen).
version
-
Die
configVersion
,modelVersion
undtaxonomyVersion
, mit Doppelpunkten (:
) zwischen jedem zusammengefügt.
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
Diese Funktion ist kein Teil eines offiziellen Standards, auch wenn sie im Topics API Unofficial Proposal Draft spezifiziert ist.
Browser-Kompatibilität
BCD tables only load in the browser