Topics API – Demos

Experimentieren Sie und erfahren Sie, wie Themen mit minimalem Einrichtungsaufwand aus Hostnamen abgeleitet werden.

Implementierungsstatus

  • Die Topics API hat die öffentliche Diskussionsphase abgeschlossen und ist derzeit für 99 % der Nutzer verfügbar. Eine Skalierung auf bis zu 100 % ist möglich.
  • Wenn Sie Feedback zur Topics API geben möchten, können Sie in der Erläuterung zu Topics ein Problem erstellen oder in der Unternehmensgruppe zur Verbesserung der Webwerbung an Diskussionen teilnehmen. Sie enthält eine Reihe offener Fragen, die noch genauer definiert werden müssen.
  • Im Privacy Sandbox-Zeitplan finden Sie den Zeitplan für die Implementierung der Topics API und anderer Privacy Sandbox-Vorschläge.
  • Im Artikel Topics API: Neueste Updates finden Sie Informationen zu Änderungen und Verbesserungen der Topics API und deren Implementierungen.

In der Topics API-Demo erfahren Sie, wie Themen aus Hostnamen abgeleitet werden. Sie können in einer Vorschau sehen, welche Themen auf einer Demowebsite beobachtet werden. Die Einrichtung ist hierfür sehr gering.

Unsere Demo ist eine Vorschau, in der die meisten Funktionen der Topics API gezeigt werden. So können Sie sich mit der Implementierung der API vertraut machen.

Sie können auch die Topics API ausführen, um das Topics-Klassifikatormodell auszuprobieren.

Das folgende Video zeigt, wie die Demo funktioniert.

Mit „chrome://flags“ oder „feature“-Flags testen

Es gibt zwei Möglichkeiten, die Topics API als einzelner Nutzer auszuprobieren. Sie benötigen Chrome 101 oder höher:

  • Alle APIs zum Datenschutz bei Werbung unter chrome://settings/adPrivacy aktivieren.

  • Führen Sie Chrome mit den folgenden Flags über die Befehlszeile aus:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Demo zur Topics API

In der Themendemo wird gezeigt, wie Sie zusätzliche Flags verwenden, um Einstellungen wie die Epochenlänge anzupassen. Wenn Sie auf die Topics API über Chrome mit Befehlszeilen-Flags zugreifen, legen Sie chrome://flags nicht fest, da diese die Befehlszeileneinstellungen überschreiben können.

Unter Chromium mit Flags ausführen erfahren Sie, wie Sie beim Ausführen von Chrome und anderen Chromium-basierten Browsern über die Befehlszeile Flags setzen. Diese Demo bezieht sich jedoch speziell auf Google Chrome.

Demo für Header der Topics API

In der Demo unter topics-fetch-demo.glitch.me wird gezeigt, wie Sie mithilfe von fetch()-Anfrage- und -Antwortheadern auf Themen zugreifen und sie als beobachtet markieren.

Auf den Anfrageheader Sec-Browsing-Topics zugreifen

Anstatt document.browsingTopics() in einem iFrame zu verwenden, um die Themen eines Nutzers anzusehen, können API-Aufrufer über den Anfrageheader Sec-Browsing-Topics einer fetch()-Anfrage auf beobachtete Themen zugreifen, in deren Optionsparameter {browsingTopics: true} enthalten ist, oder über den gleichen Header einer XHR-Anfrage, die das Attribut deprecatedBrowsingTopics auf true festlegt.

Beispiel:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

In Browsern, die die API unterstützen, enthält die fetch()-Anfrage einen Sec-Browsing-Topics-Header, der die Themen auflistet, die für den Hostnamen der Anfrage-URL beobachtet wurden: in diesem Beispiel topics-server.glitch.me.

Wenn für diesen Hostnamen und diesen Nutzer keine Themen beobachtet wurden, wird der Header eingeschlossen, aber der Wert ist leer. Mit anderen Worten, der Sec-Browsing-Topics-Header in einer fetch()-Anfrage enthält nur Themen, die im Browser des aktuellen Nutzers von einem Aufrufer beobachtet wurden, dessen Ursprung mit dem Hostnamen der Anfrage-URL übereinstimmt. Das Gleiche gilt, wenn Sie document.browsingTopics() über einen iFrame aufrufen, um beobachtete Themen für den aktuellen Nutzer anzusehen.

Der Anfrageheader wird bei einer Anfrage gesendet, sofern die entsprechende Berechtigungsrichtlinie aktiv ist, der Kontext sicher ist und die Nutzereinstellungen dies zulassen. In den Überschriften für Navigationsanfragen werden keine Themen enthalten.

Der Anfrageheader „Topics“ sieht so aus:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

Dieses Beispiel enthält zwei Themen aus der Thementaxonomie, 186 und 265, sowie die Versionsinformationen für jedes Thema.

Die Aufnahme des Themen-Headers in XHR-Anfragen ist nur vorübergehend möglich. Der Support wird in Zukunft entfernt.

Themen als beobachtet mit Observe-Browsing-Topics markieren

Wenn eine Anfrage einen Sec-Browsing-Topics-Header und die Antwort auf diese Anfrage einen Observe-Browsing-Topics: ?1-Header enthält, werden die Themen aus dem Anfrageheader vom Browser als beobachtet markiert. Beobachtete Themen können von der Topics API berechnet werden. Dieser Mechanismus entspricht der Funktionalität, die bei Verwendung der JavaScript API in einem iFrame bereitgestellt wird.

Im Screenshot unten sehen Sie die Themen, die beim Besuch der Websites auf der API-Demoseite aufgezeichnet wurden.

Demoseite der Topics API auf glitch.me
Die glitch.me-Demo zum Testen der API.

Diese Liste zeigt die Websites, die du aus der Demo aufrufen kannst, um Themen zu erfassen, die dich interessieren. Wie Sie sehen können, ist die Kategorie „Kunst und Unterhaltung/Humor“ im Screenshot nicht das Thema einer dieser Websites. Daher wurde dieses erfasste Thema als mögliche, zufällige 5 %-Themen hinzugefügt.

  • pets-animals-pets-cats.glitch.me
  • cats-cats-cats-cats.glitch.me
  • cats-pets-animals-pets.glitch.me
  • cats-feline-meow-purr-whiskers-pet.glitch.

Auf der chrome://topics-internals-Seite kannst du auf dem Tab „Themenstatus“ nachsehen, welche Themen echt sind und welche zufällig. Dieser Screenshot zeigt ein Beispiel aus verschiedenen Browsersitzungen.

Auf dem Tab „Themenstatus“ finden Sie Informationen zu den beobachteten Themen.
Tab „Themenstatus“ mit realen und zufälligen Themen

Nächste Schritte

Wenn Sie Anzeigentechnologie-Entwickler sind, können Sie mit der Topics API experimentieren und sie testen. Ausführlichere Ressourcen finden Sie im Entwicklerleitfaden.

Reagieren und Feedback geben