Benutzerdefinierte Zielgruppen in der Befehlszeile prüfen

Protected Audience bietet eine Reihe von APIs zum Beitreten und Verlassen benutzerdefinierter Zielgruppen als Teil des android.adservices.customaudience-Pakets. Zur Fehlerbehebung stehen CLI-Befehle zum Auflisten und Aufrufen benutzerdefinierter Zielgruppen zur Verfügung. In diesem Leitfaden wird beschrieben, wie Anzeigentechnologie-Entwickler den Status ihrer verknüpften benutzerdefinierten Zielgruppen prüfen können.

Einrichtung

Aus Sicherheits- und Datenschutzgründen sind benutzerdefinierte Zielgruppen standardmäßig nicht sichtbar und können nur zu Debugging-Zwecken direkt geprüft werden. Sie sind nur sichtbar, wenn die folgenden Anforderungen erfüllt sind:

  • Systemweite Entwickleroptionen sind aktiviert
  • android:debuggable="true" wird in der Datei „AndroidManifest.xml“ der App deklariert, aus der CustomAudience beigetreten wurde (mit joinCustomAudience oder fetchAndJoinCustomAudience).
  • Die Einwilligung für von Apps vorgeschlagene Werbung ist aktiviert

Adservices-Shell-Befehle aktivieren

  1. Starte dein Gerät neu, um den adservices-Prozess zu beenden.
  2. Prüfen Sie, ob adservices ausgeführt wird. Für den folgenden Befehl wird eine leere Ausgabe erwartet.
adb shell ps -A | grep adservices

Führen Sie dann die folgenden Befehle aus, um adservices-Shellbefehle zu aktivieren:

adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true

Benutzerdefinierte Zielgruppen auflisten

Wenn Sie eine bestimmte benutzerdefinierte Zielgruppe aufrufen möchten, führen Sie den folgenden Befehl aus. Geben Sie dabei owner als das Paket an, mit dem die Zielgruppe erstellt wurde, und buyer als die ID für das Werbenetzwerk, das die Zielgruppe verwaltet:

adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>

Die Ausgabe ist ein JSON-Objekt, das ein Array custom_audiences enthält. Die Struktur der Elemente in diesem Array entspricht der Ausgabe des Befehls „Benutzerdefinierte Zielgruppe ansehen“, der als Nächstes beschrieben wird.

Bestimmte benutzerdefinierte Zielgruppe ansehen

Wenn Sie eine bestimmte benutzerdefinierte Zielgruppe aufrufen möchten, führen Sie den folgenden Befehl aus und geben Sie owner als Paket an, mit dem die Zielgruppe erstellt wurde, buyer als Kennung für das Werbenetzwerk, das die Zielgruppe verwaltet, und name als Name der Zielgruppe:

adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>

Eine bestimmte benutzerdefinierte Zielgruppe aktualisieren

Wenn Sie die tägliche Aktualisierung für eine bestimmte benutzerdefinierte Zielgruppe manuell auslösen möchten, führen Sie den folgenden Befehl aus. Geben Sie dabei owner als Paket an, mit dem die Zielgruppe erstellt wurde, buyer als Kennung für das Werbenetzwerk, das die Zielgruppe verwaltet, und name als Name der Zielgruppe:

adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.