Benutzerdefinierte Zielgruppen über die Befehlszeile prüfen

Protected Audience bietet eine Reihe von APIs, mit denen Sie benutzerdefinierten Zielgruppen als Teil des Pakets android.adservices.customaudience. Für Debugging-Zwecken sind Befehlszeilenbefehle zum Auflisten und Anzeigen benutzerdefinierten Zielgruppen. In diesem Leitfaden werden die Schritte beschrieben, die Entwickler im Bereich Anzeigentechnologie ausführen müssen, um können Sie den Status der verknüpften benutzerdefinierten Zielgruppen prüfen.

Einrichtung

Aus Sicherheits- und Datenschutzgründen sind benutzerdefinierte Zielgruppen standardmäßig nicht sichtbar und können nur zur Fehlerbehebung direkt überprüft werden. Sie sind nur sichtbar Verwenden Sie diese Befehle, wenn die folgenden Anforderungen erfüllt sind:

  • Systemweite Entwickleroptionen sind aktiviert
  • android:debuggable="true" wird in der AndroidManifest.xml-Datei des App, über die die CustomAudience verbunden wurde (mit joinCustomAudience oder fetchAndJoinCustomAudience)
  • 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 nicht ausgeführt wird. Für das erwartet Sie eine leere Ausgabe: folgenden Befehl.
adb shell ps -A | grep adservices

Führen Sie dann die folgenden Befehle aus, um adservices-Shell-Befehle 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 und geben Sie Folgendes an: owner als Paket, mit dem die Zielgruppe erstellt wurde, und buyer als das ID für das Werbenetzwerk, über das die Zielgruppe verwaltet wird:

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

Die Ausgabe ist ein JSON-Objekt mit dem Array custom_audiences. Die Struktur der Elemente in diesem Array entspricht der Ausgabe der Ansicht benutzerdefinierten Zielgruppenbefehls erstellen.

Eine bestimmte benutzerdefinierte Zielgruppe aufrufen

Wenn Sie eine bestimmte benutzerdefinierte Zielgruppe aufrufen möchten, führen Sie den folgenden Befehl aus und geben Sie Folgendes an: owner als Paket, mit dem die Zielgruppe erstellt wurde, buyer als das ID des Werbenetzwerks, über das die Zielgruppe verwaltet wird, 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

Führen Sie den Befehl folgenden Befehl geben Sie owner als Paket an, das den Zielgruppe, die buyer als Kennung für das Werbenetzwerk, das die Zielgruppe und name als Name der Zielgruppe:

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