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 verwenden.
Der HTTP Sec-Browsing-Topics
Request-Header sendet die ausgewählten Themen für den aktuellen Nutzer zusammen mit der zugehörigen Anfrage, die von einer Werbetechnologie-Plattform verwendet werden, um eine personalisierte Anzeige auszuwählen.
Wenn die aufrufende Website die Topics API nicht in einem erfolgreichen Registrierungsprozess für die Privacy Sandbox enthalten hat, schlägt der Versuch, Sec-Browsing-Topics
zu erstellen oder zu ändern, stillschweigend fehl, und jeder bestehende Sec-Browsing-Topics
Header wird gelöscht.
Siehe Verwendung der Topics API für weitere Details.
Header-Typ | Request-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 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 darstellt, das verwendet wird, um einen String (wie z.B. den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersion
-
Ein String, der die verwendete Taxonomie-Version darstellt.
topic
-
Eine Nummer, die die ID des Themas darstellt, welche vom Browser verwendet werden kann, um das Thema aus der Taxonomie abzurufen (siehe ein Beispiel für eine Interessentaxonomie).
version
-
Die
configVersion
,modelVersion
undtaxonomyVersion
, durch Doppelpunkte (:
) zwischen jedem Teil verbunden.
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.
Browser-Kompatibilität
BCD tables only load in the browser