Sprawdzanie niestandardowych list odbiorców w wierszu poleceń

Protected Audience API udostępnia szereg interfejsów API do dołączania i opuszczania niestandardowych odbiorców w ramach pakietu android.adservices.customaudience. Dla: w celach debugowania dostępne są polecenia interfejsu wiersza poleceń umożliwiające wyświetlanie i wyświetlanie listy niestandardowych odbiorców. Z tego przewodnika dowiesz się, jakie czynności muszą wykonać deweloperzy technologii reklamowych. aby sprawdzić stan połączonych list niestandardowych odbiorców.

Konfiguracja

Ze względów bezpieczeństwa i ochrony prywatności grupy niestandardowych odbiorców są domyślnie niewidoczne i można ją sprawdzać bezpośrednio tylko na potrzeby debugowania. Są tylko widoczne za pomocą tych poleceń, jeśli spełnione są te wymagania:

  • Włączone są dostępne w całym systemie opcje programisty
  • android:debuggable="true" jest zadeklarowany w pliku AndroidManifest.xml w komponencie aplikacja, z której została połączona CustomAudience (przy użyciu joinCustomAudience lub fetchAndJoinCustomAudience).
  • Zgoda na wyświetlanie reklam sugerowanych przez aplikacje jest włączona

Włącz polecenia powłoki adservices

  1. Aby zakończyć proces adservices, ponownie uruchom urządzenie.
  2. Potwierdź, że aplikacja adservices nie jest uruchomiona. Oczekiwane są puste dane wyjściowe tego polecenia.
adb shell ps -A | grep adservices

Następnie, aby włączyć polecenia powłoki adservices, uruchom te polecenia:

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

Wyświetl listę niestandardowych odbiorców

Aby wyświetlić konkretną listę odbiorców niestandardowych, uruchom następujące polecenie, podając owner jako pakiet, który utworzył listę odbiorców, a buyer jako identyfikator sieci reklamowej, która zarządza listą odbiorców:

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

Będzie to obiekt JSON zawierający tablicę custom_audiences. Struktura elementów w tej tablicy odpowiada wynikom widoku niestandardowego polecenia odbiorców opisane poniżej.

Wyświetlanie konkretnej listy niestandardowych odbiorców

Aby wyświetlić konkretną listę odbiorców niestandardowych, uruchom następujące polecenie, podając owner, czyli pakietu, który utworzył listę odbiorców, a buyer identyfikatora sieci reklamowej, która zarządza listą odbiorców, oraz identyfikatora name jako nazwa listy odbiorców:

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

Odświeżanie konkretnej listy niestandardowych odbiorców

Aby ręcznie wyświetlić codzienną aktualizację reguły dla określonej niestandardowej grupy odbiorców, uruchom to polecenie, podając owner jako pakiet, za pomocą którego utworzono jako odbiorcy, buyer to identyfikator sieci reklamowej, która zarządza lista odbiorców, a name to nazwa listy odbiorców:

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