Topics API – Demos

Experimentieren Sie und finden Sie heraus, 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 Demo zur Topics API wird gezeigt, wie Themen von Hostnamen abgeleitet werden. Sie können sich eine Vorschau der Themen ansehen, die beim Besuch einer Demowebsite beobachtet werden, was sehr wenig Einrichtung erfordert.

Unsere Demo ist eine Vorschau, die die meisten Funktionen der Topics API demonstriert, damit Sie sich mit der Implementierung der API vertraut machen können.

Sie können auch das Collab für Topics ausführen, um das Klassifizierungsmodell für Topics zu testen.

Das folgende Video zeigt, wie die Demo funktioniert.

Mit chrome://flags oder Funktions-Flags testen

Es gibt zwei Möglichkeiten, die Topics API als einzelner Nutzer zu testen. Dazu muss Chrome 101 oder höher installiert sein:

  • Aktivieren Sie die API auf der Chrome-Seite chrome://flags/#privacy-sandbox-ads-apis:

    Topics API über die Seite „chrome://flags/#privacy-sandbox-ads-apis“ aktivieren
    Die Seite chrome://flags/#privacy-sandbox-ads-apis, auf der Sie die API aktivieren oder deaktivieren können.

  • 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 sehen Sie, wie Sie mit zusätzlichen Flags Einstellungen wie Epochenlänge anpassen können. Wenn Sie auf die Topics API zugreifen, indem Sie Chrome mit Befehlszeilen-Flags ausführen, legen Sie chrome://flags nicht fest, da diese Befehlszeileneinstellungen überschreiben können.

In Chromium mit Flags ausführen wird erläutert, wie Flags gesetzt werden, wenn Chrome und andere Chromium-basierte Browser über die Befehlszeile ausgeführt werden. Diese Demo bezieht sich jedoch nur auf Google Chrome.

Demo zu Headern der Topics API

Die Demo unter topics-fetch-demo.glitch.me zeigt, wie fetch()-Anfrage- und -Antwortheader verwendet werden, um auf Themen zuzugreifen und sie als beobachtet zu markieren.

Auf den Anfrageheader Sec-Browsing-Topics zugreifen

Anstatt document.browsingTopics() in einem iFrame zu verwenden, um Themen für einen Nutzer anzusehen, können API-Aufrufer über den Sec-Browsing-Topics-Anfrageheader einer fetch()-Anfrage, in deren Optionsparameter {browsingTopics: true} enthalten ist, auf beobachtete Themen zugreifen. Alternativ können sie auf denselben Header einer XHR-Anfrage zugreifen, bei der das deprecatedBrowsingTopics-Attribut auf true gesetzt wird.

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, in dem Themen aufgelistet werden, die für den Hostnamen der Anfrage-URL beobachtet werden: in diesem Beispiel topics-server.glitch.me.

Wenn für diesen Hostnamen und diesen Nutzer keine Themen gefunden wurden, wird der Header eingefügt, aber der Wert ist leer. Mit anderen Worten: Der Sec-Browsing-Topics-Header 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. Dies ist dasselbe, als würden Sie document.browsingTopics() über einen iFrame aufrufen, um die beobachteten Themen für den aktuellen Nutzer aufzurufen.

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

Der Anfrageheader für Themen 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 die zwei Themen 186 und 265 aus der Taxonomie für Themen sowie die Versionsinformationen für jedes Thema.

Die Angabe der Themenüberschrift in XHR-Anfragen ist nur vorübergehend möglich. Der Support wird in Zukunft eingestellt.

Themen mit Observe-Browsing-Topics als beobachtet markieren

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

Der folgende Screenshot zeigt die Themen, die beim Besuch der Websites auf der API-Demoseite aufgezeichnet wurden.

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

In dieser Liste sind die Websites aufgeführt, die du aus der Demo besuchen kannst, um deine Interessensgebiete aufzuzeichnen. Wie Sie sehen, ist die Kategorie „Kunst und Unterhaltung/Humor“ im Screenshot nicht das Thema einer dieser Websites. Dieses aufgezeichnete Thema wurde daher als mögliche 5 % Zufallsthemen 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 dem Tab „Themenstatus“ auf der chrome://topics-internals-Seite können Sie prüfen, welche Themen echt und welche zufällig sind. Dieser Screenshot zeigt ein Beispiel aus verschiedenen Browsersitzungen.

Der Tab „Themenstatus“ enthält Informationen zu beobachteten Themen.
Tab „Status der Themen“ mit echten und zufälligen Themen.

Nächste Schritte

Wenn Sie ein AdTech-Entwickler sind, können Sie die Topics API experimentieren und ausprobieren. Ausführlichere Ressourcen finden Sie im Entwicklerleitfaden.

Reagieren und Feedback geben