Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 dieKompatibilitä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 Browseranbietern abgelehnt. Details zur Ablehnung finden Sie im AbschnittStandards Positionen unten.
Hinweis:EinAnmeldeverfahren ist erforderlich, um diese Funktion in Ihren Anwendungen zu nutzen.
DiebrowsingTopics() Methode desDocument Interfaces gibt ein Promise zurück, das mit einem Array von Objekten erfüllt wird, die die Top-Themen des Nutzers darstellen, eines aus jeder der letzten drei Epochen. Diese Themen könnten dann in einer nachfolgenden Abrageanfrage an die Ad-Tech-Plattform zurückgegeben werden. Standardmäßig führt die Methode dazu, dass der Browser den aktuellen Seitenbesuch als vom Aufrufer beobachtet aufzeichnet, damit der Hostname der Seite später in der Themenberechnung verwendet werden kann.
SieheVerwendung der Topics API für weitere Details.
Hinweis:browsingTopics() verlässt sich nicht auf HTTP-Header, um Themen zu senden und als beobachtet zu markieren, im Gegensatz zu den anderenTopics API aktivierenden Funktionen, ist jedoch etwas weniger performant. Es wird empfohlen, eine der HTTP-Header-verwendenden Funktionen zu verwenden und aufbrowsingTopics() nur in Situationen zurückzugreifen, in denen die Header nicht geändert werden können.
Syntax
browsingTopics()browsingTopics(options)Parameter
optionsOptionalEin Optionsobjekt, das die folgenden Eigenschaften enthalten kann:
skipObservationEin boolescher Wert, der, wenn er auf
truegesetzt ist, dazu führt, dass der Browser keine Themen beobachtet, wennbrowsingTopics()aufgerufen wird. Der Standardwert istfalse, was dazu führt, dass Themen beobachtet werden.
Rückgabewert
EinPromise, das mit einem Array von bis zu drei Objekten erfüllt wird, die die ausgewählten Themen des aktuellen Nutzers für die letzten drei Epochen darstellen. Jedes Objekt enthält die folgenden Eigenschaften:
configVersionEin String, der den Algorithmus identifiziert (außer dem Modellteil), der zur Berechnung des Themas verwendet wird.
modelVersionEin String, der das Modell darstellt, das verwendet wird, um einen String (wie den Hostnamen einer Webseite) in Themen-IDs zu klassifizieren.
taxonomyVersionEin String, der die verwendete Taxonomie-Version darstellt.
topicEine Nummer, die die ID des Themas darstellt, die vom Browser genutzt werden kann, um das Thema aus der Taxonomie abzurufen (siehe ein BeispielTaxonomie der Interessen).
versionDie
configVersion,modelVersionundtaxonomyVersion, mit Doppelpunkten (:) zwischen jeder verkettet.
Die genauen Eigenschaftswerte können je nach Browser-Implementierung variieren. Ein Beispielobjekt aus Chrome könnte wie folgt aussehen:
{ "configVersion": "chrome.1", "modelVersion": "1", "taxonomyVersion": "1", "topic": 43, "version": "chrome.1:1:1"}Ausnahmen
NotAllowedErrorDOMExceptionWird ausgelöst, wenn:
- Die Nutzung derTopics API durch eine
browsing-topicsBerechtigungsrichtlinie untersagt ist. - Die aufrufende Seite die Topics API nicht in einem erfolgreichenPrivacy Sandbox Anmeldeprozess enthalten hat.
- Die Nutzung derTopics API durch eine
Beispiele
// Get an array of top topics for this userconst topics = await document.browsingTopics();// Request an ad creativeconst response = await fetch("https://ads.example/get-creative", { method: "POST", headers: { "Content-Type": "application/json", }, body: JSON.stringify(topics),});// Get the JSON from the responseconst creative = await response.json();// Display adSpezifikationen
Diese Funktion ist kein Teil eines offiziellen Standards, obwohl sie imTopics API Unofficial Proposal Draft spezifiziert ist.