Dokument: browsingTopics() Methode

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

Hinweis: Ein Registrierungsprozess ist erforderlich, um diese Funktion in Ihren Anwendungen zu verwenden.

Die browsingTopics()-Methode der Document-Schnittstelle gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird, die die Top-Themen des Benutzers repräsentieren, eines aus jedem der letzten drei Zeitabschnitte. Diese Themen könnten dann bei einer nachfolgenden Fetch-Anfrage an die Werbetechnologie-Plattform zurückgegeben werden. Standardmäßig führt die Methode auch dazu, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, sodass der Hostname der Seite später in die Themenberechnung einbezogen werden kann.

Hinweis: browsingTopics() verlässt sich nicht auf HTTP-Header, um Themen zu senden und als beobachtet zu markieren, wie die anderen Funktionen, die die Topics API ermöglichen, ist jedoch etwas weniger leistungsfähig. Es wird empfohlen, eine der HTTP-Header-verwendenden Funktionen zu nutzen und nur dann auf browsingTopics() zurückzugreifen, wenn die Header nicht geändert werden können.

Syntax

browsingTopics()
browsingTopics(options)

Parameter

options Optional

Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:

skipObservation: Ein boolescher Wert, der, wenn er auf true gesetzt ist, dazu führt, dass der Browser keine Themen beobachtet, wenn browsingTopics() aufgerufen wird. Der Standardwert ist false, was dazu führt, dass Themen beobachtet werden.

Rückgabewert

Ein Promise, das mit einem Array von bis zu drei Objekten erfüllt wird, die die ausgewählten Themen des aktuellen Benutzers für die letzten drei Zeitabschnitte repräsentieren. Jedes Objekt enthält die folgenden Eigenschaften:

configVersion: Ein String, der den Algorithmus (außer dem Modellteil) identifiziert, der verwendet wird, um das Thema zu berechnen.
modelVersion: Ein String, der das Modell repräsentiert, das verwendet wird, um einen String (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersion: Ein String, der die verwendete Taxonomieversion repräsentiert.
topic: Eine Zahl, die die ID des Themas repräsentiert, 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, konkateniert mit Doppelpunkten (:) zwischen jeder.

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

json

{
 "configVersion": "chrome.1",
 "modelVersion": "1",
 "taxonomyVersion": "1",
 "topic": 43,
 "version": "chrome.1:1:1"
}

Ausnahmen

NotAllowedError DOMException

Wird ausgelöst, wenn:

Die Verwendung der Topics API durch eine browsing-topics Permissions Policy untersagt ist.
Die aufrufende Seite die Topics API nicht in einen erfolgreichen Datenschutz-Sandbox-Registrierungsprozess einbezogen hat.

Beispiele

// Get an array of top topics for this user
const topics = await document.browsingTopics();
// Request an ad creative
const response = await fetch("https://ads.example/get-creative", {
 method: "POST",
 headers: {
 "Content-Type": "application/json",
 },
 body: JSON.stringify(topics),
});
// Get the JSON from the response
const creative = await response.json();
// Display ad

Topics API

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden