Sprawdzanie niestandardowych list odbiorców w wierszu poleceń

Protected Audience API udostępnia szereg interfejsów API, które umożliwiają dołączanie i opuszczanie niestandardowych list odbiorców w ramach pakietu android.adservices.customaudience. Do debugowania możesz używać poleceń interfejsu wiersza poleceń, które służą do wyświetlania list i wyświetlania list 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 prywatności niestandardowe listy odbiorców nie są domyślnie widoczne i można je bezpośrednio sprawdzać na potrzeby debugowania. Są one widoczne za pomocą tych poleceń tylko wtedy, gdy 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 aplikacji, z której zostało połączone pole CustomAudience (za pomocą 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. Poniższe polecenie powinno zawierać puste dane wyjściowe.
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ą niestandardową listę odbiorców, uruchom to polecenie, podając owner jako pakiet, który utworzył listę odbiorców, oraz 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 wynikowi opisanego poniżej polecenia Wyświetl niestandardowe polecenie odbiorców.

Wyświetlanie konkretnej listy niestandardowych odbiorców

Aby wyświetlić konkretną niestandardową listę odbiorców, uruchom to polecenie, podając owner jako pakiet, który utworzył listę odbiorców, buyer jako identyfikator sieci reklamowej, która zarządza listą odbiorców, oraz name jako nazwę 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 wyświetlić codzienną aktualizację wyzwalacza w przypadku określonej grupy odbiorców niestandardowych, uruchom to polecenie, podając owner jako pakiet, który utworzył listę odbiorców, buyer jako identyfikator sieci reklamowej zarządzającej listą odbiorców, a name jako nazwę listy odbiorców:

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