Sprawdzanie list odbiorców niestandardowych w wierszu poleceń

Protected Audience udostępnia serię interfejsów API do dołączania do niestandardowych grup odbiorców i opuszczania ich w ramach pakietu android.adservices.customaudience. Na potrzeby debugowania dostępne są polecenia CLI do wyświetlania i przeglądania niestandardowych list odbiorców. Ten przewodnik zawiera informacje o krokach, które deweloperzy technologii reklamowych muszą wykonać, aby sprawdzić stan połączonych niestandardowych list odbiorców.

Konfiguracja

Ze względów bezpieczeństwa i ochrony prywatności niestandardowe listy odbiorców nie są domyślnie widoczne i można je bezpośrednio sprawdzać tylko na potrzeby debugowania. Są one widoczne po użyciu tych poleceń tylko wtedy, gdy są spełnione te wymagania:

  • Włączono opcje programisty w całym systemie
  • android:debuggable="true" jest zadeklarowany w pliku AndroidManifest.xml aplikacji, z której CustomAudience został dołączony (za pomocą joinCustomAudience lub fetchAndJoinCustomAudience).
  • Zgoda na reklamy sugerowane przez aplikacje jest włączona

Włączanie poleceń powłoki adservices

  1. Uruchom ponownie urządzenie, aby zakończyć proces adservices.
  2. Sprawdź, czy adservices nie jest uruchomiony. W przypadku tego polecenia oczekiwane są puste dane wyjściowe.
adb shell ps -A | grep adservices

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świetlanie niestandardowych grup odbiorców

Aby wyświetlić konkretną listę odbiorców niestandardowych, uruchom to 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>

Dane wyjściowe będą obiektem JSON zawierającym tablicę custom_audiences. Struktura elementów w tej tablicy jest zgodna z wynikiem polecenia view custom audience opisanego poniżej.

Wyświetlanie konkretnej niestandardowej listy odbiorców

Aby wyświetlić konkretną listę 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 view --owner <owner> --buyer <buyer> --name <name>

Odświeżanie konkretnej niestandardowej listy odbiorców

Aby ręcznie wyświetlić codzienną aktualizację wyzwalacza dla konkretnego segmentu niestandardowego, uruchom to polecenie, podając owner jako pakiet, który utworzył segment, buyer jako identyfikator sieci reklamowej zarządzającej segmentem i name jako nazwę segmentu:

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