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.

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 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

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.

Nächste Schritte

Hier finden Sie Implementierungsdetails und Codebeispiele, mit denen Anrufer Themen beobachten und darauf zugreifen können.
Hier erfahren Sie, wie Nutzer und Entwickler die Topics API verwalten und an die Vorlieben und Anforderungen der Nutzer anpassen können.

Weitere Informationen

In unseren Ressourcen finden Sie weitere Informationen zur Topics API für Android.