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: Dieses Feature wird derzeit von zwei Browserherstellern abgelehnt. Siehe den Abschnitt Positionen der Standards 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 Anfrage, die von einer Werbetechnologie-Plattform verwendet werden, um eine personalisierte Anzeige auszuwählen.

Falls 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 vorhandene Sec-Browsing-Topics Header werden gelöscht.

Siehe Verwendung der Topics API für weitere Details.

Header-Typ Anforderungs-Header
Verbotener Anforderungs-Header Ja (Sec- Präfix)

Syntax

http
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 (abgesehen vom Modellteil) identifiziert, der zur Berechnung des Themas verwendet wird.

modelVersion

Ein String, der das Modell darstellt, das verwendet wird, um eine Zeichenkette (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.

taxonomyVersion

Ein String, der die verwendete Taxonomieversion 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 Taxonomie der Interessen).

version

Die configVersion, modelVersion und taxonomyVersion, zusammengefügt mit Doppelpunkten (:) dazwischen.

Beispiele

Die genauen Eigenschaftswerte können je nach Browser-Implementierung variieren. Ein Beispiel-Header von Chrome könnte wie folgt aussehen:

http
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 spezifiziert ist.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch