Проверка индивидуально настроенной аудитории в командной строке

В рамках пакета android.adservices.customaudience сервис Protected Audience предоставляет ряд API для присоединения к пользовательским аудиториям и выхода из них. Для отладки доступны команды CLI для отображения списка пользовательских аудиторий. В этом руководстве описаны шаги, которые должны выполнить разработчики рекламных технологий для проверки состояния присоединенных пользовательских аудиторий.

Настраивать

В целях безопасности и конфиденциальности пользовательские аудитории по умолчанию не отображаются и могут быть просмотрены только в целях отладки. Они становятся видимыми с помощью этих команд только при выполнении следующих условий:

  • Системные параметры разработчика включены.
  • android:debuggable="true" указан в файле AndroidManifest.xml приложения, из которого была подключена CustomAudience (с помощью joinCustomAudience или fetchAndJoinCustomAudience ).
  • Согласие на показ рекламы, предлагаемой приложением, включено.

Включите команды оболочки adservices

  1. Перезагрузите устройство, чтобы завершить процесс работы adservices .
  2. Подтвердите, что adservices не запущен. Для следующей команды ожидается пустой вывод. 
adb shell ps -A | grep adservices

Затем, чтобы включить команды оболочки adservices , выполните следующие команды:

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

Список пользовательских аудиторий

Чтобы просмотреть определенную пользовательскую аудиторию, выполните следующую команду, указав в качестве owner пакет, создавший аудиторию, а в качестве идентификатора рекламной сети, управляющей аудиторией, — buyer :

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

В результате будет получен JSON-объект, содержащий массив custom_audiences . Структура элементов этого массива соответствует результату выполнения команды view custom audience, описанной далее.

Просмотр определенной пользовательской аудитории

Чтобы просмотреть определенную пользовательскую аудиторию, выполните следующую команду, указав в качестве owner пакет, создавший аудиторию, в качестве buyer — идентификатор рекламной сети, управляющей аудиторией, и в name имени аудитории:

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

Обновить определенную пользовательскую аудиторию

Чтобы вручную просмотреть ежедневные обновления для определенной пользовательской аудитории, выполните следующую команду, указав в качестве owner пакет, создавший аудиторию, в качестве buyer — идентификатор рекламной сети, управляющей аудиторией, и в name имени аудитории:

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