Topics API für das Web

Die Topics API ermöglicht interessenbezogene Werbung ohne Drittanbieter-Cookies.

Funktionsweise der Topics API

Mit der Topics API können Themen beobachtet und Zugriff darauf gewährt werden, die aufgrund der Aktivitäten des Nutzers für ihn von Interesse zu sein scheinen. Die Topics API kann API-Callern (z. B. Anzeigentechnologie-Plattformen) dann Zugriff auf die Themen eines Nutzers gewähren, ohne zusätzliche Informationen zu den Aktivitäten des Nutzers preiszugeben.

Wichtige Konzepte

  • Ein Thema ist ein für Menschen lesbares Thema, das für den aktuellen Nutzer von Interesse ist. Es ist Teil der Topics-Taxonomie.
  • Ein Caller ist eine Entität wie eine App, ein SDK eines Drittanbieters, eine Website oder ein Dienst, die eine Anfrage an die Topics API senden, um die Interessen eines Nutzers zu beobachten oder darauf zuzugreifen.
  • Ein Thema wird von einem Aufrufer beobachtet, wenn er in den letzten drei Zeiträumen eine Topics API-Anfrage von einer Webseite oder App gesendet hat, die mit diesem Thema verknüpft ist.
  • Eine Epoche ist ein Zeitraum für die Themenberechnung, der standardmäßig eine Woche beträgt.
  • Eine Taxonomie ist eine hierarchische Liste von Kategorien, die beispielsweise Kategorien wie /Arts & Entertainment/Music & Audio/Soul & R&B und /Business & Industrial/Business Services/Corporate Events umfasst.
  • Themen werden mithilfe eines Klassifizierungsmodells abgeleitet, das Nutzeraktivitäten einem oder mehreren Themen zuordnet.

Wichtige Schritte im Ablauf der Topics API

Der Lebenszyklus der Topics API umfasst drei Hauptschritte:

  • Beobachten Sie die Nutzeraktivitäten, z. B. wenn sie die Webseite https://cats.example/tabby/index.html besuchen oder die App cats herunterladen.
  • Themen aus Nutzeraktivitäten ableiten, z. B. /Pets & Animals/Pets/Cats.
  • Zugriff auf Themen, die zuvor für den Nutzer beobachtet wurden, z. B. als Signal zur Auswahl relevanter Werbung (z. B. Werbung für Katzenfutter).

Themen beobachten

Anrufer können nur auf Themen zugreifen, die sie beobachtet haben. Ein Aufrufer beobachtet ein Thema, wenn er eine Topics API-Anfrage aus einem mit diesem Thema verknüpften Kontext stellt. Das folgende vereinfachte Beispiel veranschaulicht dieses Konzept.

  • Angenommen, es gibt zwei Topics API-Aufrufer: A und B.
  • Es gibt zwei Kontexte:
    • Greenhouse, z. B. eine App namens „Greenhouse“ oder eine Website „greenhouse.beispiel“, die mit dem Thema Home & Garden verknüpft ist.
    • Tennisübungen, z. B. eine App namens „Tennisübungen“ oder eine Website namens „tennis.beispiel“, die dem Thema Sports/Tennis zugeordnet ist.
  • Sowohl A als auch B sind im Kontext von Greenhouse vorhanden.
  • Im Kontext von Tennisübungen ist nur der Aufrufer B vorhanden.
  • Angenommen, vor der Epoche 1 wurden für den Nutzer keine Themen beobachtet.
  • Der Nutzer besucht die Greenhouse App und die Aufrufer A und B führen einen Topics API-Aufruf aus, um den Besuch der Seite oder App zu erfassen. Weitere Informationen zum Aufrufen der Topics API finden Sie im Implementierungsleitfaden unter Nächste Schritte. Dieser Eintrag (ein Hostname oder App-Daten) wird später verwendet, um Themen von Interesse abzuleiten. Die Topics API kennzeichnet das Thema Home & Garden später als von beiden Aufrufern A und B beobachtet.
  • Der Nutzer ruft die App Tennisübungen auf. Nur der Aufrufer B sendet eine Topics API-Anfrage. Die Topics API kennzeichnet das Thema Sports/Tennis später als vom Aufrufer B beobachtet.
  • Am Ende der Epoche aktualisiert die Topics API die Top-Themen des Nutzers und ermittelt anhand der Nutzeraktivitäten die Aufrufer, die diese Themen beobachtet haben.
  • Wenn der Aufrufer B später einen weiteren Topics API-Aufruf ausführt, kann er im Antwortarray entweder das Thema Home & Garden oder Sports/Tennis (oder mit einer Wahrscheinlichkeit von 5% ein zufälliges Thema) für diesen Nutzer erhalten.
  • Caller A kann nur auf das Thema Home & Garden zugreifen, da er das Thema Sports/Tennis noch nie beobachtet hat. Das bedeutet, dass Drittanbieter nur im spezifischen Kontext (App oder Website), in dem das Thema vorhanden ist, über das Interessengebiet eines Nutzers erfahren.
Diagramm, das zeigt, dass die Topics API die Themen nur als beobachtet kennzeichnet, wenn der Aufrufer im Kontext präsent ist.
Die Topics API kennzeichnet die Themen nur für die Aufrufer, die im Kontext dieser Themen präsent sind. Die Anrufer können nur auf die Themen zugreifen, die sie beobachtet haben.

Themen ableiten

Topics leitet Themen von Interesse aus Nutzeraktivitäten ab. Die Themen werden aus einer vordefinierten Open-Source-Taxonomie ausgewählt. Einmal pro Epoche werden die fünf wichtigsten Themen des Nutzers und die Aufrufer, die sie während der Epoche beobachtet haben, in Topics aktualisiert. Das Klassifizierungsmodell für Themen leitet Themen aus Nutzeraktivitäten ab: Hostname für einen Webseitenbesuch, App-Informationen unter Android.

Anrufer greift auf die Themen von Interesse des Nutzers zu

Die API gibt nur Themen zurück, die vom Aufrufer in den letzten drei Epochen beobachtet wurden. Es können maximal drei Themen für einen Aufrufer zurückgegeben werden,jeweils ein Thema für jede der drei letzten Epochen (sofern der Aufrufer Themen für diese Epoche beobachtet hat). Die zurückgegebenen Themen können vom Aufrufer verwendet werden, um Kontextinformationen zu ergänzen. Sie können auch kombiniert werden, um eine relevantere Anzeige für den Nutzer zu finden.

Epochen

Die Topics API muss dafür sorgen, dass die angegebenen Themen auf dem neuesten Stand gehalten werden. Die Themen werden für einen Nutzer anhand seiner Aktivitäten in einem bestimmten Zeitraum abgeleitet, der als Epoche bezeichnet wird und standardmäßig eine Woche umfasst. Jeder Nutzer hat seine eigenen Epochen (Epochen sind „pro Nutzer“) und der Startzeitpunkt wird zufällig festgelegt.

Einmal pro Epoche berechnet die Topics API die fünf wichtigsten Themen des Nutzers und ermittelt anhand von On-Device-Informationen, welche Aufrufer diese Themen beobachtet haben. Das Thema einer Epoche wird nach dem Zufallsprinzip aus den fünf relevantesten Themen des Nutzers für den jeweiligen Zeitraum ausgewählt. Um den Datenschutz weiter zu verbessern und dafür zu sorgen, dass alle Themen vertreten sind, wird das Thema mit einer Wahrscheinlichkeit von 5% nach dem Zufallsprinzip aus allen möglichen Themen in der Taxonomie der Interessen ausgewählt.

Themen im Web in der Praxis

Im Web werden Themen aus den Hostnamen der Seiten abgeleitet, die der Nutzer besucht. Das für die Website „dogs.example“ abgeleitete Thema könnte beispielsweise /Haustiere und Tiere/Haustiere/Hunde sein.

Das folgende Diagramm zeigt ein vereinfachtes Beispiel dafür, wie die Topics API einer Ad-Tech-Plattform helfen kann, eine geeignete Anzeige auszuwählen. Im Beispiel wird davon ausgegangen, dass der Browser des Nutzers bereits ein Modell hat, um Website-Hostnamen Themen zuzuordnen.

Diagramm mit den Phasen im Lebenszyklus der Topics API, von einem Nutzer, der Websites besucht, bis zur Anzeige einer Anzeige.
Im Diagramm zum Lebenszyklus der Topics API werden die Phasen der API-Aktionen aus einer übergeordneten Perspektive dargestellt.

Der Ursprung des Aufrufers wird vom Browser aus dem Kontext des Codes ermittelt, der die Topics API aufruft. In der Praxis bedeutet das, dass Topics-Nutzer die API in einem iFrame von ihrem Ursprung aus aufrufen oder Themen in einen fetch zu ihrem Ursprung einfügen.

Eine Supply-Side-Plattform (SSP) kann beispielsweise auf mehreren Websites von Publishern eingebettet werden. Die SSP kann dann die Topics API innerhalb eines iFrames von ihrem Ursprung aus aufrufen, um Themen zu beobachten, die mit einem Nutzer auf den Websites dieser Publisher verknüpft sind. Diese Themen können dann an eine Demand-Side-Plattform (DSP) weitergegeben werden, um eine relevante Anzeige für den Nutzer auszuwählen.

Wie die API entscheidet, welche Anrufer welche Themen sehen

API-Aufrufer erhalten nur Themen, die sie in letzter Zeit beobachtet haben. Die Themen für einen Nutzer werden einmal pro Epoche aktualisiert. In der Chrome-Implementierung ist eine Epoche auf eine Woche festgelegt. Das bedeutet, dass die API ein rollierendes Zeitfenster bietet, in dem ein bestimmter Aufrufer beobachtete Themen erhalten kann.

Die folgende Tabelle enthält ein Beispiel (das allerdings unrealistisch klein ist) für einen hypothetischen Browserverlauf eines Nutzers während einer einzelnen Epoche. Sie zeigt Themen, die mit den besuchten Websites verknüpft sind, und die API-Aufrufer auf jeder Website (die Entitäten, die document.browsingTopics() im JavaScript-Code auf der Website aufrufen).

Website Themen API-Aufrufer auf der Website
running.example Running & Walking
Athletic Shoes		 adtech1.example
adtech2.example
dogs.example Dogs adtech1.example
holiday.example Hotels & Accommodations adtech2.example
sunglasses.example Sunglasses [none]

Am Ende des Zeitraums (standardmäßig eine Woche) generiert die Topics API die Top-Themen des Browsers für die Woche.

  • adtech1.example kann jetzt die Themen Running & Walking, Athletic Shoes und Dogs erhalten, da sie auf running.example und dogs.example beobachtet wurden.
  • adtech1.example kann das Thema Hotels & Accommodations für diesen Nutzer nicht erhalten, da es auf keiner der Websites vorhanden ist, die der Nutzer in letzter Zeit besucht hat und die mit diesem Thema verknüpft sind.
  • adtech2.example hat die Themen Running & Walking, Athletic Shoes und Hotels & Accommodations gesehen, aber nicht das Thema Dogs.

Der Nutzer hat die Website sonnenbrillen.beispiel besucht, die das Thema Sunglasses hat. Auf dieser Website gab es jedoch keine Aufrufe der Topics API. Das bedeutet, dass das Thema Sunglasses zu diesem Zeitpunkt von der API für keinen Aufrufer zurückgegeben wird.

In der zweiten Woche besucht der Nutzer eine andere Website:

Website Themen API-Aufrufer auf der Website
cameras.example Camera & Photo Equipment adtech2.example

Außerdem wird Code von adtech2.example zu sunglasses.example hinzugefügt:

Website Themen API-Aufrufer auf der Website
sunglasses.example Sunglasses adtech2.example

Neben Running & Walking, Athletic Shoes und Hotels & Accommodations aus Woche 1 kann adtech2.example jetzt auch die Themen Camera & Photo Equipment und Sunglasses empfangen – allerdings erst in der folgenden Epoche, also in Woche 3. So wird verhindert, dass Drittanbieter mehr über die Vergangenheit eines Nutzers (in diesem Fall ein Interesse an Mode) erfahren, als sie mit Cookies erfahren könnten.

Nach weiteren zwei Wochen, am Running & Walking, können Athletic Shoes und Hotels & Accommodations aus der Liste der zulässigen Themen von adtech2.example entfernt werden, wenn der Nutzer keine Websites mit diesen Themen besucht, die Code von adtech2.example enthalten.

Die Schritte, die die Topics API ausführt, wenn Nutzer Websites besuchen, auf denen die API verwendet wird.
Wie die API Themen beobachtet und darauf zugreift.

Klassifikatormodell

Bei Topics wird ein Klassifizierungsmodell verwendet, mit dem Website-Hostnamen null oder mehr Themen zugeordnet werden. Durch die Analyse zusätzlicher Informationen wie vollständiger URLs oder Seiteninhalte könnten relevantere Anzeigen ausgeliefert werden, dies könnte jedoch auch die Privatsphäre beeinträchtigen.

Taxonomie

Die Themen werden aus einer Taxonomie ausgewählt. Diese Themen wurden von Chrome zusammengestellt. Ziel ist es, dass die Taxonomie zu einer Ressource wird, die von vertrauenswürdigen Beiträgern aus der Community verwaltet wird. Die Taxonomie muss klein genug sein, damit die Browser vieler Nutzer mit jedem Thema verknüpft werden. Das Ziel ist, dass die Taxonomie von einem externen Unternehmen stammt, das Feedback und Ideen aus der gesamten Branche berücksichtigt.

Damit sensible Kategorien vermieden werden, müssen Themen öffentlich sein, von Menschen kuratiert werden und auf dem neuesten Stand bleiben. Die von Chrome verwendete Taxonomie wurde von Menschen kuratiert, um Kategorien auszuschließen, die allgemein als sensibel gelten, z. B. ethnische Herkunft oder sexuelle Orientierung.

Themenklassifizierung

Themen werden manuell für 50.000 Top-Websites zusammengestellt. Diese kuratierte Überschreibungsliste mit Hostnamen und Themen wird zum Trainieren des Klassifizierungsmodells verwendet. Bei den wichtigsten Websites werden Themen über die Überschreibungsliste aufgerufen und nicht über das Klassifikatormodell. Sie können die Überschreibungsliste lokal auf Ihrem Computer aufrufen.

Die Seite „chrome://topics-internals“ mit ausgewähltem Bereich „Classifier“.
Im Bereich „Klassifizierer“ auf der Seite chrome://topics-internals werden die Modellversion, der Pfad und die Themen aufgeführt, die mit den einzelnen aufgeführten Hosts verknüpft sind.

Bei der Implementierung der Topics API in Chrome wird eine TensorFlow Lite-Datei heruntergeladen, die das Modell repräsentiert. So kann es lokal auf dem Gerät des Nutzers verwendet werden.

So werden die fünf wichtigsten Themen eines Nutzers ausgewählt

Die API gibt für jede Epoche ein Thema zurück, maximal drei. Wenn drei zurückgegeben werden, sind Themen für die aktuelle Epoche und die beiden vorherigen enthalten.

  1. Am Ende jeder Epoche erstellt der Browser eine Liste von Seiten, die die folgenden Kriterien erfüllen:
    • Die Seite wurde während des Zeitraums vom Nutzer besucht.
    • Die Seite enthält Code, der document.browsingTopics() aufruft.
    • Die API wurde aktiviert (z. B. nicht vom Nutzer oder durch einen Antwortheader blockiert).
  2. Der Browser auf dem Gerät des Nutzers verwendet das von der Topics API bereitgestellte Klassifizierungsmodell, um den Hostnamen für jede Seite einer Liste von Themen zuzuordnen.

  3. Der Browser generiert eine Liste der fünf wichtigsten Themen.

    • Jedes der 22 Stammthemen in der Taxonomie wird basierend auf dem Feedback aus dem Werbe-Ökosystem entweder einem Bucket mit „hohem Nutzen“ oder „Standardnutzen“ zugewiesen. Der Browser sortiert Themen zuerst nach ihrer Bucket-Zuweisung. Alle untergeordneten Themen übernehmen die Bucket-Zuweisung ihres übergeordneten Root-Themas. Themen mit hohem Nutzen werden priorisiert.
    • Der Browser sortiert die Themen dann nach Häufigkeit innerhalb der einzelnen Gruppen.
    • Die fünf wichtigsten Themen aus dieser sortierten Liste werden als die wichtigsten Themen des Nutzers für diese Epoche ausgewählt.

Die Methode document.browsingTopics() gibt dann für jede Epoche ein zufälliges Thema aus den fünf relevantesten Themen zurück. Es besteht eine Wahrscheinlichkeit von 5 %, dass eines dieser Themen zufällig aus der vollständigen Taxonomie der Themen ausgewählt wird. In Chrome können Nutzer auch einzelne Themen entfernen oder ihren Browserverlauf löschen, um die Anzahl der von der API zurückgegebenen Themen zu verringern. Nutzer können die API auch deaktivieren.

Auf der Seite chrome://topics-internals können Sie Informationen zu Themen aufrufen, die während des aktuellen Zeitabschnitts beobachtet wurden.

Next steps

Get your environment ready to test and develop web applications with the Topics API.
Check out implementation details and code samples for callers to observe and access topics.

Weitere Informationen

In unseren Ressourcen finden Sie weitere Informationen zur Topics API im Web.