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
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, wennbrowsingTopics()
aufgerufen wird. Der Standardwert istfalse
, 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
undtaxonomyVersion
, durch Doppelpunkte (:
) zwischen den einzelnen verbunden.
Die genauen Eigenschaftswerte können je nach Browserimplementierung variieren. Ein Beispielobjekt von Chrome könnte wie folgt aussehen:
{
configVersion: "chrome.1",
modelVersion: "1",
taxonomyVersion: "1",
topic: 43,
version: "chrome.1:1:1"
}
Ausnahmen
NotAllowedError
DOMException
-
Wird ausgelöst, wenn:
- Die Nutzung der Topics API durch eine
browsing-topics
Berechtigungspolice untersagt ist. - Die aufrufende Seite die Topics API nicht in einem erfolgreichen Privacy Sandbox Anmeldeprozess eingeschlossen hat.
- Die Nutzung der Topics API durch eine
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
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 GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
browsingTopics |
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.