Topics API für das Web

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

How the Topics API works

The Topics API can be used to observe and provide access to topics that appear to be of interest to the user, based on their activity. The Topics API can then give API callers (such as ad tech platforms) access to a user's topics of interest, but without revealing additional information about the user's activity.

Key concepts

• A topic is a human-readable topic of interest for the current user and is part of the Topics taxonomy.
• A caller is an entity, such as an app, a third-party SDK, a website, or service, that makes a request to the Topics API to observe or access a user's interests.
• A topic is observed by a caller, if the caller made a Topics API request from a web page or app associated with this topic during the past three epochs.
• An epoch is a period of topic computation, which defaults to one week.
• A taxonomy is a hierarchical list of categories, which includes, for example, such categories as /Arts & Entertainment/Music & Audio/Soul & R&B and /Business & Industrial/Business Services/Corporate Events.
• Topics are derived using a classifier model that maps user activity to zero or more topics.

Topics API flow core steps

The Topics API lifecycle has three main steps:

• Observe user activity, such as when they visit the web page https://cats.example/tabby/index.html or download the app cats.
• Derive topics from user activity, for example /Pets & Animals/Pets/Cats.
• Access topics previously observed for the user, for example as a signal to select relevant advertising (such as a cat food promotion).

Observe topics

Callers can only access topics of interest that they've observed. A caller observes a topic when they make a Topics API request from a context associated with this topic. To illustrate this concept, consider the following simplified example.

• Suppose there are two Topics API callers: A and B.
• There are two contexts:
  • Greenhouse, for example an app named Greenhouse or a website greenhouse.example, associated with the topic Home & Garden.
  • Tennis exercises, for example an app named Tennis Exercises or a website tennis.example, associated with the topic Sports/Tennis.
• Both caller A and B are present in the context of Greenhouse.
• Only the caller B is present in the context of Tennis exercises.
• Assume that no topics were observed for the user before epoch 1, for the sake of simplification.
• The user visits the Greenhouse app, and callers A and B make a Topics API call to record the user visit to the page or app (see the implementation guide suggested in Next steps to find out how to call the Topics API). This record (a hostname or app data) is later used to derive topics of interest. The Topics API will later mark the topic Home & Garden as observed by both callers A and B.
• The user visits the Tennis exercises app. Only the caller B sends a Topics API request. The Topics API will later mark the topic Sports/Tennis as observed by the caller B.
• By the end of the epoch, the Topics API refreshes the user's top topics and determines the callers that observed these topics based on user activity.
• Later, when the caller B makes another Topics API call, it can get either Home & Garden or Sports/Tennis topic (or, with a 5% chance, a random topic) for this user in the response array.
• Caller A can only access the topic Home & Garden, as it has never observed the topic Sports/Tennis. This means that a third-party will only learn about a user's topic of interest within the specific context (app or website) where it is present.

Derive topics

Topics derives topics of interest from user activity. The topics are selected from a predefined open-source taxonomy. Once per epoch, Topics refreshes the user's top five topics and the callers that observed them during the epoch. The Topics classifier model derives topics from user activity: hostname for a web page visit, app information on Android.

Caller accesses user's topics of interest

The API returns only topics that have been observed by the caller within the most recent three epochs. A maximum of three topics may be returned to a caller,one topic for each of the three recent epochs (if the caller observed topics for that epoch). The returned topics can be used by the caller to supplement any contextual information and can be combined to help find a more relevant ad for the user.

Epochs

The Topics API must ensure that the topics of interest it provides are kept up to date. The topics are inferred for a user based on their activity during a period of time known as an epoch, one week by default. Each user has their own epochs (epochs are "per user") and the initial start time is randomized.

Once each epoch, the Topics API computes the user's top five topics and determines which callers observed those topics using on-device information. The topic selected for each epoch is randomly selected from the user's top five topics for that time period. To further enhance privacy and ensure that all topics may be represented, there is a 5% chance the topic is randomly selected from all possible topics in the taxonomy of interests.

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.

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.

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.

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

Weitere Informationen

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

• Sehen Sie sich Demos, Collabs und Schritt-für-Schritt-Anleitungen zu Topics an.
• In der Liste der Chrome-Flags finden Sie Informationen dazu, wie Entwickler die Topics API für Tests anpassen können.
• Hier erfahren Sie, wie Nutzer und Entwickler die API steuern können.
• In den Ressourcen finden Sie technische Erläuterungen und Support. Stellen Sie Fragen, nehmen Sie teil und geben Sie Feedback.