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. Details zur Ablehnung finden Sie im Abschnitt Standards-Poistionen.

Hinweis: Ein Einschreibungsverfahren ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.

Der HTTP Sec-Browsing-Topics Request-Header sendet die ausgewählten Themen des aktuellen Benutzers zusammen mit der zugehörigen Anfrage, die von einer Werbetechnologieplattform verwendet werden, um eine personalisierte Werbung auszuwählen, die angezeigt werden soll.

Wenn die aufrufende Seite die Topics API nicht in einem erfolgreichen Einschreibungsprozess im Privacy Sandbox einbezogen hat, schlägt der Versuch, Sec-Browsing-Topics zu erstellen oder zu ändern, ohne Fehlermeldung fehl, und jeglicher vorhandene Sec-Browsing-Topics-Header wird gelöscht.

Weitere Details finden Sie unter Verwendung der Topics API.

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 vom aktuellen Benutzer ausgewählten Themen für die letzten drei Epochen 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 Zeichenkette (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.

taxonomyVersion

Eine Zeichenkette, die 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 Taxonomie von Interessen).

version

Die configVersion, modelVersion und taxonomyVersion, durch Doppelpunkte (:) getrennt.

Beispiele

Die genauen Eigenschaftswerte können je nach Browserimplementierung 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

Diese Funktion ist kein Teil eines offiziellen Standards, obwohl sie im Unoffiziellen Entwurfsvorschlag der Topics API spezifiziert ist.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch