Sec-Browsing-Topics header
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. 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.
Warnung: Diese Funktion wird derzeit von zwei Browseranbietern abgelehnt. Weitere Informationen zur Ablehnung finden Sie im Abschnitt Standards positions.
Hinweis: Ein Anmeldeverfahren ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.
Der HTTP Sec-Browsing-Topics Request-Header sendet die ausgewählten Themen des aktuellen Nutzers zusammen mit der zugehörigen Anfrage, die von einer Werbetechnologie-Plattform verwendet werden, um eine personalisierte Anzeige auszuwählen, die angezeigt werden soll.
Wenn die aufrufende Seite die Topics API nicht in einem erfolgreichen Anmeldeverfahren für die Privacy Sandbox integriert hat, schlägt der Versuch, Sec-Browsing-Topics zu erstellen oder zu ändern, ohne Fehlermeldung fehl, und jeder vorhandene Sec-Browsing-Topics-Header wird gelöscht.
Siehe Verwendung der Topics API für weitere Details.
| Header-Typ | Request-Header |
|---|---|
| Verbotener Request-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 Nutzers 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 repräsentiert, das verwendet wird, um eine Zeichenkette (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersion-
Eine Zeichenkette, die die verwendete Taxonomieversion repräsentiert.
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, zusammengefügt mit Doppelpunkten (:) dazwischen.
Beispiele
Die genauen Eigenschaftswerte können je nach Browserimplementierung variieren. Ein Beispiel-Header aus 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, obwohl sie im Topics API Unofficial Proposal Draft spezifiziert ist.