Topics API für Mobilgeräte: Übersicht

Informationen zur Topics API unter Android und zu den Schritten, die für die Implementierung erforderlich sind. Sie können auch direkt mit der Implementierung von Themen beginnen.

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 unter Android in der Praxis

Die Topics API für Android wurde entwickelt, um Drittanbieter-Werbe-SDKs zu unterstützen, die in der Regel in mehreren Apps verwendet werden. Topics stellt Anrufern allgemeine Werbethemen zur Verfügung, die auf der App-Nutzung des Nutzers basieren, ohne dass app-übergreifende Kennungen erforderlich sind. Diese Themen können verwendet werden, um Kontextinformationen zur App zu ergänzen, in der eine Anzeige ausgeliefert werden soll. Sie können auch kombiniert werden, um eine geeignete Anzeige für den Nutzer auszuwählen.

Im Zusammenhang mit der Topics API sind Käufer und Werbetreibende von der Verkaufsseite abhängig. Die Verkäuferseite ist in den Apps des Publishers breit vertreten und beobachtet die Themen der Nutzer. Anschließend werden die Themen an die Käufer weitergegeben, damit diese relevantere Anzeigen auswählen können. Um Themen zu erhalten, müssen Sell-Side-Apps und ‑SDKs einen Footprint aufbauen, indem sie mindestens eine Epoche lang die Topics API beobachten.

Im Implementierungsleitfaden für die Topics API finden Sie Codebeispiele, die zeigen, wie Sie die Möglichkeit zum Abrufen von Themen für interessenbasierte Werbung einrichten.

Themenintegration nach Unternehmenstyp

Aktivieren Sie die interessenbezogene Werbung mit der Topics API. Folgen Sie den Schritten, die für Ihr Ad-Tech-Unternehmen gelten, um die Topics API einzubinden und sich auf die Einführung vorzubereiten.

Für alle AdTech-Produkte

• Sehen Sie sich die Thementaxonomie an und geben Sie Feedback.
• Mit den Beispiel-Apps für die Topics API können Sie ausprobieren, welche Themen vom On-Device-Klassifikator zurückgegeben werden.
• App- und SDK-Abläufe aktualisieren, um die Topics API aufzurufen
• Protokolle aktualisieren, damit Themen in Anzeigenanfragen gesendet werden
• Registrieren Sie Ihre Anzeigentechnologie für die Privacy Sandbox.

Für AdTech auf der Verkaufsseite

• Werden Sie zum Beobachter, um eine Topics API-Präsenz zu schaffen. Die Topics API bietet ein neues Signal. Sie müssen Ihr SDK also aktualisieren, um die Topics API aufzurufen. Damit Themen konsistent abgerufen werden können, muss Ihr SDK die API mindestens einmal pro Epoche aus Publisher-Apps aufrufen. Es kann bis zu vier Epochen dauern, bis die maximale Anzahl an Themen (drei Themen) mit Ihren Anzeigenanfragen gesendet wird.
• Informationen zur Topics API in Ihre Anzeigenanfragen einfügen Beginnen Sie, Ihre Topics API-Daten für jede Anzeigenanfrage mit Partnern auf Käuferseite zu teilen. Die Topics API soll andere Signale (z. B. Kontextsignale) ergänzen, um eine geeignete Anzeige für einen bestimmten Besucher zu finden.
• Arbeiten Sie mit Ihren Buy-Side-Partnern an einem Protokoll für die gemeinsame Nutzung von Themen. Für die Topics API muss jedes SDK mit Downstream-Partnern zusammenarbeiten, um zu vereinbaren, wie Topics API-Daten weitergegeben werden.

Für Anzeigentechnologien für Käufer

• Wenden Sie sich an Sell-Side-Partner, um ihre Pläne zur Beobachtung von Themen und zur Etablierung einer Präsenz zu bestätigen. Um Themen zu erhalten, müssen verkaufsseitige Anbieter die Topics API mindestens einmal pro Epoche aufrufen.
• Arbeiten Sie mit Ihren Sell-Side-Partnern an einem Protokoll für den Empfang von Themen. „Themen“ ist ein neues Signal, das von Sell-Side-Partnern im Rahmen der Anzeigenanfrage freigegeben wird. Käufer müssen mit ihren Upstream-Partnern klären, wie Themen geteilt werden.
• Themen in Gebots- und Optimierungsmodelle einbeziehen Es wird erwartet, dass die Topics API andere Signale wie Kontextsignale ergänzt, um dazu beizutragen, geeignete Werbung für den Besucher zu finden.

So leitet die API Themen für eine App ab

Unter Android leitet die Topics API Themen für eine App anhand von App-Informationen mithilfe eines Klassifizierungsmodells ab. In der aktuellen Implementierung werden App- und Paketnamen verwendet, um einer App interessenbezogene Themen zuzuweisen. Dies kann später auf andere Informationen wie die App-Beschreibung ausgeweitet werden.

Themenklassifikator

Interessenthemen werden aus einem Klassifizierungsmodell abgeleitet, das mit öffentlich verfügbaren App-Informationen trainiert wird.

• Wenn das Klassifikatormodell für die Inferenz verwendet wird, um die Themen für eine bestimmte Epoche zu berechnen, verbleiben die verwendeten Signale auf dem Gerät. Diese Signale können installierte oder kürzlich verwendete Apps umfassen und später um weitere Signale erweitert werden.
• Das V5-Modell wurde von Google mit 540.000 öffentlich verfügbaren App-Informationen aus App-Stores wie dem Google Play Store trainiert, die von Menschen gekennzeichnet wurden, sowie mit 17 Millionen öffentlich verfügbaren App-Informationen, die von ML gekennzeichnet wurden. Das Modell verwendet App-Namen und Paketnamen als Eingabesignale. App-Entwickler können es kostenlos testen und herausfinden, welchen Themen ihre App zugeordnet wird.
• Es ist möglich, dass eine App mehreren oder keinen Themen zugeordnet wird oder nicht im Themenverlauf des Nutzers enthalten ist. Wenn eine App mehr als einem Thema in der Taxonomie zugeordnet ist, wird die Anzahl der für diese App ausgewählten Themen auf die drei wichtigsten beschränkt.

Um besser zu verstehen, wie das Klassifizierungsmodell funktioniert, können Sie mit dem Android Topics Classifier Colab testen, wie sich verschiedene App-Daten auf die Klassifizierung auswirken.

Taxonomie

Die Themen werden aus einer vordefinierten Open-Source-Taxonomie ausgewählt. Die Taxonomie ist öffentlich verfügbar und kann sich ändern. Vorschläge können über die Schaltfläche „Feedback“ oben auf dieser Seite eingereicht werden. Diese Taxonomie wird von Menschen kuratiert, sodass sensible Themen nicht Teil der Taxonomie sind. Sie wird auf die Kategorien von Anzeigen zugeschnitten, die in mobilen Apps auf Android-Geräten ausgeliefert werden können.

Themen unter Android in der Praxis

Angenommen, ein Nutzer hat sieben Apps auf seinem Gerät installiert: A, B, C, D, E, F und G. Angenommen, die Themenklassifizierung für die App und die Ad-Tech-SDKs in diesen Apps ist wie folgt:

App	Themenklassifizierung	AdTech-SDK
A	T1, T5	ad-sdk1, ad-sdk2
B	T2	ad-sdk2
C	T3, T6	ad-sdk3, ad-sdk4
D	T1, T4	ad-sdk1
E	T5	ad-sdk4, ad-sdk5
F	T6	ad-sdk2, ad-sdk3, ad-sdk4
G	T7	ad-sdk2

Ende der ersten Woche: Die Topics API generiert die fünf wichtigsten Themen des Nutzers für diese Epoche.

Top-Thema	Anrufer, die sich über das Thema informieren können
T1	ad-sdk1, ad-sdk2
T2	ad-sdk2
T3	ad-sdk3, ad-sdk4
T4	ad-sdk1
T5	ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

Wenn in Woche 2 ein Anrufer in einer beliebigen App die API aufruft, enthält die zurückgegebene Themenliste nur Themen, für die der Anrufer für diese App und diese Epoche in der Spalte „Anrufer, die mehr über das Thema erfahren können“ aufgeführt ist.

• Der Verlaufszeitraum, der in die Berechnung der für jeden Anrufer verfügbaren Themen einbezogen wird, umfasst drei Epochen (oder drei Wochen).
• Es werden nur Themen verwendet, die mit Apps verknüpft sind, die die Topics API über Anzeigen-SDKs aufrufen. Wenn eine App keine Werbe-SDKs enthält, die die Topics API aufrufen, tragen die mit dieser App verknüpften Themen nicht zum Pool der Themen bei, auf die Werbe-SDKs zugreifen können.
• Eine App kann die Topics API auch deklarativ deaktivieren. Themen, die mit deaktivierten Apps verknüpft sind, werden nicht in die wöchentliche Themenberechnung einbezogen. Dieses Dokument wird aktualisiert, um entsprechende Implementierungsdetails aufzunehmen.

Wenn die App nicht oft genug verwendet wird, um fünf Themen abzuleiten, kann die Plattform Optionen wie das zufällige Generieren der verbleibenden Themen in Betracht ziehen.

Verschlüsselung zurückgegebener Themen

Registrierte AdTech-Plattformen, die die Topics API aufrufen, müssen außerdem Verschlüsselungsschlüssel bereitstellen, damit die zurückgegebenen Themen nur für den Aufrufer lesbar sind.

Die Privacy Sandbox ruft diese Schlüssel vom Endpunkt ab, der vom Anbieter von Anzeigentechnologien bereitgestellt wird . Wir empfehlen, die Schlüssel regelmäßig zu aktualisieren, mindestens jedoch alle sechs Monate.

Im Rahmen der Privacy Sandbox werden Anbieter von Anzeigentechnologien aufgefordert, die Verfügbarkeit des Endpunkts zu bestätigen, den sie während der Registrierung angegeben haben. Weitere Informationen zu den erforderlichen Maßnahmen für aktuelle und neu registrierte Ad-Tech-Unternehmen finden Sie im Registrierungsleitfaden.

Next steps

See also

Check out our resources to better understand the Topics API on Android.

• Check out Topics sample apps, collab and walkthrough videos.
• See how users and developers can control the API.
• Check out the support resources to ask questions, engage and share feedback.