Sec-Browsing-Topics header
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.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Warnung: Diese Funktion wird derzeit von zwei Browser-Anbietern abgelehnt. Siehe den Abschnitt Standpunkt der Standardisierungsorganisationen für Details zur Ablehnung.
Hinweis: Ein Registrierungsprozess ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.
Der HTTP-Sec-Browsing-Topics-Anfrage-Header sendet die ausgewählten Themen für den aktuellen Benutzer zusammen mit der zugehörigen Anfrage, die von einer Werbetechnologie-Plattform genutzt werden, um eine personalisierte Werbung auszuwählen, die angezeigt werden soll.
Wenn die aufrufende Seite die Topics-API nicht in einem erfolgreichen Registrierungsprozess für die Privacy Sandbox beinhaltet, schlägt der Versuch, Sec-Browsing-Topics zu erstellen oder zu ändern, stillschweigend fehl, und ein vorhandener Sec-Browsing-Topics-Header wird gelöscht.
| Header-Typ | Anfrage-Header |
|---|---|
| Verbotener Anfrage-Header | 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-
Eine Zeichenfolge, die den Algorithmus identifiziert (mit Ausnahme des Modellteils), 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, die vom Browser verwendet werden kann, um das Thema aus der Taxonomie abzurufen (siehe ein Beispiel für eine Interessen-Taxonomie).
version-
Die
configVersion,modelVersionundtaxonomyVersion, verkettet mit Doppelpunkten (:) zwischen jedem.
Beispiele
Die genauen Eigenschaftenwerte 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 nicht Teil eines offiziellen Standards, obwohl sie im inoffiziellen Entwurfsvorschlag der Topics API spezifiziert ist.