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 sich in einer Vorschau anzeigen lassen, welche Themen auf einer Demowebsite beobachtet werden. Dies erfordert sehr wenig Einrichtung.
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: benötigen Sie 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 Taxonomie der Themen, 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.
<ph type="x-smartling-placeholder">![Demoseite der Topics API auf glitch.me](https://developers.google.cn/static/privacy-sandbox/assets/images/topics-api-demo-page-gli-1a52a773264c2.png?authuser=9&hl=de)
Diese Liste zeigt die Websites, die du aus der Demo aufrufen kannst, um Themen zu erfassen, die dich interessieren. Wie Sie sehen, Die Kategorie „Unterhaltung/Humor“ im Screenshot ist nicht das Thema einer dieser Websites. Das erfasste Thema wurde daher 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.](https://developers.google.cn/static/privacy-sandbox/assets/images/the-topics-state-tab-prov-4a016e2640bad.png?authuser=9&hl=de)
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
- GitHub: Lesen Sie die Erläuterung zur Topics API, stellen Sie Fragen und folgen Sie den Diskussionen zu Problemen im API-Repository.
- W3C Erörtern Sie Anwendungsfälle aus der Branche in der Improving Web Advertising Business Group.
- Ankündigungen: Sie können der Mailingliste beitreten oder sie aufrufen.
- Entwicklersupport für die Privacy Sandbox: Hier können Sie Fragen stellen und sich an Diskussionen zum Privacy Sandbox-Entwicklersupport-Repository beteiligen.
- Chromium: Melden Sie einen Fehler in Chromium, um Fragen zur Implementierung zu stellen, die derzeit zum Testen in Chrome verfügbar ist.