Document: browsingTopics() Methode

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 Browser-Herstellern abgelehnt. Details zur Ablehnung finden Sie im Abschnitt Standards positions unten.

Hinweis: Ein Anmeldeverfahren ist erforderlich, um dieses Feature in Ihren Anwendungen zu nutzen.

Die browsingTopics() Methode des Document Interfaces gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird, die die Hauptthemen des Benutzers repräsentieren, eines aus jeder der letzten drei Epochen. Diese Themen könnten anschließend in einer nachfolgenden Abrufanfrage an die Werbetechnik-Plattform zurückgegeben werden. Standardmäßig bewirkt die Methode auch, dass der Browser den aktuellen Seitenbesuch, wie vom Aufrufer beobachtet, aufzeichnet, sodass der Hostname der Seite später in der Themenberechnung verwendet werden kann.

Siehe Verwendung der Topics API für weitere Details.

Hinweis: browsingTopics() verlässt sich nicht auf HTTP-Header, um Themen zu senden und wie die anderen Topics API Aktivierungs-Features Themen als beobachtet zu markieren, ist aber etwas weniger leistungsfähig. Es wird empfohlen, eines der Features zu verwenden, das HTTP-Header nutzt, und auf browsingTopics() nur in Situationen zurückzugreifen, in denen die Header nicht geändert werden können.

Syntax

js
browsingTopics()
browsingTopics(options)

Parameter

options Optional

Ein Optionsobjekt, das folgende Eigenschaften enthalten kann:

skipObservation

Ein boolescher Wert, der, wenn auf true gesetzt, bewirkt, 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, der mit einem Array von bis zu drei Objekten erfüllt wird, die die ausgewählten Themen des aktuellen Benutzers für die letzten drei Epochen repräsentieren. Jedes Objekt enthält folgende 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 Hostname 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 der Interessen).

version

Die configVersion, modelVersion und taxonomyVersion, durch Doppelpunkte (:) zwischen den einzelnen verbunden.

Die genauen Eigenschaftswerte können je nach Browserimplementierung variieren. Ein Beispielobjekt von Chrome könnte wie folgt aussehen:

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

Ausnahmen

NotAllowedError DOMException

Wird ausgelöst, wenn:

Beispiele

js
// 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

Spezifikationen

Dieses Feature ist Teil eines inoffiziellen Standards, obwohl es im Topics API Unofficial Proposal Draft spezifiziert ist.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
browsingTopics
ExperimentalNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.

Siehe auch