Topics API für Mobilgeräte – Übersicht

Feedback geben

Informationen zur Topics API

Bei mobiler Werbung möchten Werbetreibende relevante Anzeigen schalten, die einen Bezug zu einer die Interessen der Nutzer zu berücksichtigen. Wenn ein Nutzer z. B. an Informationen in Bezug auf beim Kochen sind für sie möglicherweise Anzeigen zum Thema Kochen relevanter als Anzeigen, die nicht ihren Interessen entsprechen.

Kontextbezogene Werbung basiert ausschließlich auf den Interessen, die sich aus den aktuell angesehene und beworbene Inhalte Einer der Vorteile der Mit der Topics API lassen sich Apps zulassen, die für den Nutzer nützlich sind, nicht einfach durch kontextbezogene Werbung zu monetarisieren, um relevantere Anzeigen zu schalten. als dies sonst möglich wäre. Dadurch werden die Apps finanziert, verwendet werden.

Die Topics API leitet auf dem Gerät über die Nutzung der App. Diese Signale, auch Themen genannt, werden mit Werbetreibenden geteilt, kontexuelle und andere eigene Signale unterstützen können, ohne für einzelne Nutzer in verschiedenen Apps.

Die Topics API unterstützt Werbe-SDKs von Drittanbietern, die werden in der Regel über mehrere Apps hinweg ausgeführt. Diese Unterstützung erfolgt in Form von Es werden einige App-übergreifende Interessen angezeigt, die diese SDKs normalerweise nutzen würden. beobachten. Einzelne App-Entwickler sollten keine zusätzlichen Informationen Informationen über ihre Nutzenden.

Wichtige Konzepte

• Ein Thema ist ein für Menschen lesbares Thema, das für diesen Nutzer von Interesse ist und Teil von der Taxonomie für Themen.
• Ein Thema wird von einem Aufrufer beobachtet (eine App oder ein Drittanbieter-SDK, das im app), wenn der Aufrufer eine Topics API-Anfrage von einer App gesendet hat, die mit in den letzten drei Epochen.
• Eine Epoche ist ein Zeitraum, in dem die Berechnung eines Themas stattfindet, beispielsweise eine Woche.

Funktionsweise

Mit diesem Angebot sollen Aufrufer über die Topics API grob differenzierte Werbethemen, die auf der App-Nutzung des Nutzers basieren. Diese Themen können als Ergänzung zu Kontextinformationen in Bezug auf die die eine Anzeige schalten möchte und die kombiniert werden kann, um eine geeignete Anzeige für den Nutzer.

Codebeispiele zur Veranschaulichung finden Sie im Entwicklerleitfaden zur Topics API. wie Sie die Funktion zum Abrufen von Themen für interessenbezogene Werbung einrichten. Hinweis: Die APIs sind noch nicht endgültig.

Die Themen werden aus einer vordefinierten Open-Source-Taxonomie ausgewählt.

Die Plattform verwendet ein Klassifikatormodell, um Themen abzuleiten. Die Themen Die API-Implementierung und ihre Verwendung des Klassifikators sind Teil des Android- Open-Source-Projekt erstellen und wird mit der Zeit immer besser.

Zur Veranschaulichung wird im folgenden Codebeispiel die Verwendung von Themen, um eine interessenbezogene Anzeige abzurufen. Die hier verwendeten APIs sind nicht endgültig.

// Initialize the Topics API.
…
topicsFuture = AdvertisingTopicsClient.getTopics();

// Retrieve Topics and use them in Ad request.
Futures.addCallback(
    topicsFuture,
    new FutureCallback<AdvertisingTopicsInfo>() {
        @Override
        public void onSuccess(@Nullable AdvertisingTopicsInfo topicsInfo) {
            // Sanitize Topics result.
            ...
            // Initialize ad request with Topics obtained.
            AdRequest adRequest = AdRequest.initialize(topicsInfo);
        }

        @Override
        public void onFailure(Throwable t) {
            // Handle error.
            ...
        }
});

Um die Funktionsweise des Klassifikatormodells besser zu verstehen, wie verschiedene App-Daten im System mit dem Android-Topics-Klassifikator reagieren Colab

Zugriff auf Topics APIs erhalten

AdTech-Plattformen müssen sich für den Zugriff auf die Topics API registrieren, siehe Registrieren Sie sich für ein Privacy Sandbox-Konto, um weitere Informationen zu erhalten.

Details

• Nach jeder Epoche (z. B. einmal pro Woche) werden die 5 wichtigsten Themen des Nutzers berechnet. mit Informationen auf dem Gerät.

  • Wenn die Topics API aufgerufen wird, prüft die Plattform, ob ein Thema die der App zugewiesen ist, die die API aufruft. Wenn keine zugewiesenen Themen, wird eines wie folgt ausgewählt und das ausgewählte Thema wird der App für den Rest der Epoche zugewiesen.
    • Mit einer Wahrscheinlichkeit von 95% wird ein Thema nach dem Zufallsprinzip aus der Liste der die Top 5 der berechneten Themen für diese Epoche.
    • Mit einer Wahrscheinlichkeit von 5% wird ein Thema nach dem Zufallsprinzip aus der Taxonomie ausgewählt.
    • Ein Anrufer kann angeben, dass er Themen abrufen möchte, ohne Status durch Aufrufen von getTopics mit dem Parameter ändern shouldRecordObservation = false. Das bedeutet, dass Themen zurückgegeben, aber der Aufruf wird nicht in die wöchentliche Epoche aufgenommen. und wird auch nicht die Liste der für den Test Anrufer.
  • Jede App erhält eines von mehreren Themen, dass verschiedene Apps unterschiedliche Themen haben, was Apps demselben Nutzer korrelieren können.
    • Beispiel: App A könnte Thema T1 für den Nutzer lesen, App B jedoch möglicherweise siehe Thema T2. Dadurch wird es für die beiden Apps schwieriger, dass diese Informationen demselben Nutzer zugeordnet sind.

• Die Topics API gibt eine Liste von bis zu drei Themen zurück, eines für jedes der letzten drei Themen. Epochen.

  • Wenn du bis zu drei Themen angibst, haben selten genutzte Apps ausreichend Themen, um relevante Werbung zu finden, aber häufig verwendete Apps lernen am besten 1 neues Thema pro Woche.
  • Die zurückgegebenen Themeninformationen enthalten eine Themen-ID (int), die dem einem Eintrag in der Taxonomie, einer Taxonomieversion und einem Klassifikatormodell Version.
  • Nur Anrufer, die beobachtet haben, dass der Nutzer eine mit dem Thema verknüpfte App verwendet die in den letzten drei Epochen für das Thema infrage kommen.
  • Alle zurückgegebenen Themen repräsentieren die Interessen des Nutzers. Sie können Sie können einige oder alle dieser Themen für personalisierte Werbung in Ihrer Anzeige auswählen

• Nachdem der Anwendung, die die Topics API aufruft, ein Thema zugewiesen wurde, Plattform bestimmt, ob der Aufrufer dieses Thema empfangen kann.

  • Nur Anrufer, die das Nutzer-Engagement einer App beobachtet haben, die mit dem Thema innerhalb der letzten drei Epochen kann das Thema empfangen.
  • Wenn der Aufrufer die API für diesen Nutzer in der Vergangenheit nicht in einer App aufgerufen hat zu diesem Thema gibt, wird es nicht in der Liste der von der API zurückgegeben wird.
  • Wenn der Aufrufer in den letzten drei Epochen keine Themen erhalten hat, Die Topics API gibt eine leere Liste zurück.

  Angenommen, der Nutzer hat sieben Apps auf dem Gerät installiert: A, B, C, D, E, F und G. Es wird angenommen, dass die Themenklassifizierung für die App und die Anzeige technischen SDKs in diesen Apps:

  App-Kampagnen	Klassifizierung von Themen	SDK für Anzeigentechnologien
  A	T1, T5	ad-sdk1, ad-sdk2
  B	T2	Anzeigen-SDK2
  C	T3, T6	ad-sdk3, ad-sdk4
  D	T1, T4	Anzeigen-SDK1
  E	T5	ad-sdk4, ad-sdk5
  F	T6	ad-sdk2, ad-sdk3, ad-sdk4
  G	T7	Anzeigen-SDK2

  • Ende der 1. Woche: Die Topics API generiert die 5 wichtigsten Themen des Nutzers dafür Epoche.

  Top-Thema	Anrufer, die mehr über das Thema erfahren können
  T1	ad-sdk1, ad-sdk2
  T2	Anzeigen-SDK2
  T3	ad-sdk3, ad-sdk4
  T4	Anzeigen-SDK1
  T5	ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

  • Wenn in Woche 2 ein Aufrufer in einer App die API aufruft, wird das zurückgegebene Thema enthält nur Themen, für die sich der Anrufer in der Liste die mehr über das Thema erfahren kann.“ Spalte für dieses Thema für diese App dieser Epoche.
  • Das Verlaufsfenster, das bei der Berechnung der verfügbaren Themen berücksichtigt wird Jeder Aufrufer hat 3 Epochen (oder 3 Wochen).
  • Nur Themen, die mit Apps verknüpft sind, die die Topics API über eine Anzeige aufrufen SDKs verwendet werden. Wenn eine App keine Anzeigen-SDKs enthält, die die Topics API aufrufen, werden die mit dieser App verknüpften Themen zu den Themen beitragen, auf die Anzeigen-SDKs zugreifen können.
  • Eine App kann die Topics API auch deklarativ über eine neue Manifest- und XML-Elementen enthalten, um zu verhindern, dass Anzeigen-SDKs das die API für diese Anwendung. Themen, die mit deaktivierten Apps verknüpft sind, werden nicht zur wöchentlichen Berechnung der Themen beitragen. Dieses Dokument wird um zugehörige Implementierungsdetails ergänzt.

• Wenn nicht genügend App-Nutzung vorhanden ist, um fünf Themen abzuleiten, Optionen wie die zufällige Generierung der verbleibenden Themen in Betracht zieht.

Taxonomie

• Im aktuellen Vorschlag wird die ursprüngliche Taxonomie irgendwo zwischen ein paar hunderttausend Themen. Der ursprüngliche Taxonomievorschlag werden bei einer zukünftigen Aktualisierung dieses Dokuments freigegeben.
• Diese Taxonomie wird von Menschen zusammengestellt, damit sensible Themen nicht Teil die Taxonomie.
• Diese Taxonomie wird auf die Anzeigenkategorien zugeschnitten, die auf auf Android-Geräten.
• Die Taxonomie ist öffentlich verfügbar und kann sich ändern. Über die Feedback-Schaltfläche oben auf dieser Seite kannst du uns Vorschläge machen.

Themenklassifikator

Themen von Interesse werden aus einem Klassifikatormodell abgeleitet, das mit Öffentlich verfügbaren App-Informationen (z. B. App-Name, Beschreibung und Paket) Name).

• Wenn das Klassifikatormodell für die Inferenz verwendet wird, um die Themen für eine bleiben die verwendeten Signale auf dem Gerät erhalten. Diese Reihe von können auch installierte oder kürzlich verwendete Apps sein. um weitere Signale erweitert.
• Die anfänglichen Modelle werden von Google trainiert, wobei die Trainingsdaten Folgendes umfassen: manuell zusammengestellte Labels für öffentlich verfügbare App-Informationen. Das Modell wird für Apps frei verfügbar sein, um zu testen, welche Themen in ihrer App klassifiziert werden. an.
• Die anfänglichen Modelle werden mit öffentlich verfügbaren Informationen zu Apps trainiert aus einer begrenzten Anzahl von App-Shops wie dem Google Play Store kaufen.
• Es ist möglich, dass eine App mehr als einem Thema zugeordnet ist oder keinen Themen zugeordnet ist oder dass werden sie nicht in den Themenverlauf des Nutzers übernommen. Für den Fall, dass eine App mehr als 1 Thema in der Taxonomie, die Anzahl der für diese App ausgewählten Themen auf die drei wichtigsten begrenzt.

Nutzersteuerung

• Das Design zielt darauf ab, Nutzenden die Möglichkeit zu geben, Themen, die sich auf ihre App-Nutzung beziehen. Die Implementierung dieses Die Funktion zur Nutzersteuerung befindet sich noch in der Entwicklung und wird in einer für zukünftige Updates.
• Wenn der Nutzer eine App deinstalliert, die zur Auswahl eines abgeleitetes Thema in den letzten drei Epochen, wird dieses Thema nicht aus dem Liste der für die letzten drei Epochen zurückgegebenen Themen, um eine Offenlegung Informationen zur Deinstallation.

Um das Testen der Nutzererfahrung zu erleichtern, können Sie starten Sie außerdem einen In-App-Intent, um die Einstellungen für ähnliche Topics-Themen aufzurufen. wie ein Endnutzer sie sehen würde. Hier ein Beispiel für diesen Aufruf:

//Button that launches settings UI
private Button mSettingsAppButton;
private static final String RB_SETTING_APP_INTENT = "android.adservices.ui.SETTINGS";


//Does setup for button on screen that will launch settings UI to observe Topics
private void registerLaunchSettingsAppButton() {
    mSettingsAppButton.setOnClickListener(
        new View.OnClickListener() {

            @Override
            public void onClick(View view) {
                Context context = getApplicationContext();
                Intent activity2Intent = new Intent(RB_SETTING_APP_INTENT);
                activity2Intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(activity2Intent);
            }
        });
}

Anzeigentechnologie-Plattform registrieren

Für den Zugriff auf die Topics API müssen alle AdTech-Plattformen (einschließlich Google) Sie müssen einen Anmeldeprozess durchlaufen.

App-Entwickler können festlegen, welche Anzeigentechnologie-Entwickler auf die Topics APIs zugreifen können, indem sie einschließlich der Registrierungs-ID des Anzeigentechnologie-Entwicklers in das App-Manifest.

Verschlüsselung der zurückgegebenen Themen

Registrierte Anzeigentechnologie-Plattformen, die die Topics API aufrufen, müssen außerdem Folgendes zur Verfügung stellen: Verschlüsselungsschlüssel, um sicherzustellen, dass die zurückgegebenen Themen nur für den Anrufer.

Die Privacy Sandbox ruft diese Schlüssel vom Endpunkt der Anzeigentechnologie ab. Mi. empfehlen als Best Practice, die Schlüssel häufig, aber nicht später zu aktualisieren. als alle 6 Monate.

Die Privacy Sandbox fordert Anzeigentechnologie-Experten auf, die Verfügbarkeit des Endpunkts zu bestätigen die bei der Registrierung von der Anzeigentechnologie bereitgestellt werden. Weitere Informationen zu Aktion, die für aktuelle und neu registrierte AdTechs erforderlich ist, siehe Anmeldung Entwicklerleitfaden.

Verschlüsselungsdetails

Mit der Einführung der Verschlüsselung werden Aufrufe von "GetTopics()" wird jetzt ein Antwort mit einer Liste von „EncryptedTopic“ Objekte. Wenn Sie diese Ergebnisse entschlüsseln, ergeben ein Objekt mit demselben JSON-Format wie das vorherige Topic-Objekt.

Die Topics API unterstützt die einmalige Implementierung von HPKE (Hybrid Public Key) Verschlüsselung). Wir gehen davon aus, dass der registrierte Anrufer einen öffentlichen 32-Bit-Schlüssel auf der Der öffentliche Verschlüsselungs-URL-Endpunkt, der bei der Registrierung angegeben wurde. Diese Schlüssel sind mit Base64-Codierung.

EncryptedTopic-Objekte haben drei Felder. Die Liste der zurückgegebenen Themen kann Sie erhalten den entsprechenden privaten Schlüssel als öffentlichen Schlüssel.

Zu Entwicklungszwecken können Sie die Topics API-Verschlüsselung testen, indem Sie Registrierungsprüfung durchgeführt werden. Dadurch würde die API gezwungen werden, den öffentlichen Testschlüssel für durch die Verschlüsselung Ihrer Antworten. Sie können die verschlüsselten Themen mit der für den entsprechenden privaten Schlüssel.

Persönliche Empfehlungen

• Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
• Versionshinweise
• Entwicklerleitfaden für die Protected Audience API auf Android-Geräten
• Topics API-Entwicklerleitfaden