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

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

Настраивать

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

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

Включить команды оболочки рекламных служб

  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 . Структура элементов в этом массиве соответствует выходным данным команды просмотра индивидуальной аудитории, описанной ниже.

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

Чтобы просмотреть определенную пользовательскую аудиторию, выполните следующую команду, указав 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.
,

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

Настраивать

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

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

Включить команды оболочки рекламных служб

  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 . Структура элементов в этом массиве соответствует выходным данным команды просмотра индивидуальной аудитории, описанной ниже.

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

Чтобы просмотреть определенную пользовательскую аудиторию, выполните следующую команду, указав 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.