Benutzerdefinierte Zielgruppen über die Befehlszeile prüfen

Protected Audience bietet eine Reihe von APIs, mit denen Sie benutzerdefinierte Zielgruppen im Paket android.adservices.customaudience hinzufügen und verlassen können. Für die Fehlerbehebung stehen Befehlszeilenbefehle zum Auflisten und Aufrufen benutzerdefinierter Zielgruppen zur Verfügung. In diesem Leitfaden werden die Schritte beschrieben, die Entwickler von Anzeigentechnologien ausführen müssen, um den Status ihrer verknüpften benutzerdefinierten Zielgruppen zu prüfen.

Einrichtung

Aus Sicherheits- und Datenschutzgründen sind benutzerdefinierte Zielgruppen standardmäßig nicht sichtbar und können nur zur Fehlerbehebung direkt geprüft werden. Sie sind nur dann mit diesen Befehlen sichtbar, wenn die folgenden Anforderungen erfüllt sind:

  • Systemweite Entwickleroptionen sind aktiviert
  • android:debuggable="true" wird in der AndroidManifest.xml-Datei der App deklariert, über die CustomAudience (mit joinCustomAudience oder fetchAndJoinCustomAudience) verknüpft wurde.
  • 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 den folgenden Befehl wird eine leere Ausgabe erwartet.
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. Geben Sie dabei owner als Paket an, mit dem die Zielgruppe erstellt wurde, und buyer als Kennung 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 des im Folgenden beschriebenen Befehls zum Anzeigen der benutzerdefinierten Zielgruppe.

Eine bestimmte benutzerdefinierte Zielgruppe aufrufen

Wenn Sie eine bestimmte benutzerdefinierte Zielgruppe aufrufen 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 des Werbenetzwerks, das die Zielgruppe verwaltet, und name als Namen der Zielgruppe:

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

Eine bestimmte benutzerdefinierte Zielgruppe aktualisieren

Wenn Sie das tägliche Update für eine bestimmte benutzerdefinierte Zielgruppe manuell aufrufen 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 des Werbenetzwerks, das die Zielgruppe verwaltet, und name als Namen der Zielgruppe:

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