Protected Audience предоставляет ряд API для присоединения к пользовательским аудиториям и выхода из них в рамках пакета android.adservices.customaudience . В целях отладки доступны команды CLI для составления списка и просмотра индивидуализированных аудиторий. В этом руководстве описаны шаги, которые необходимо выполнить разработчикам рекламных технологий, чтобы проверить состояние объединенных ими индивидуализированных аудиторий.
Настраивать
По соображениям безопасности и конфиденциальности пользовательские аудитории по умолчанию не отображаются, и их можно напрямую проверить только в целях отладки. Они видны с помощью этих команд только в том случае, если выполняются следующие требования:
- Общесистемные параметры разработчика включены.
-
android:debuggable="true"
объявляется в файле AndroidManifest.xml приложения, из которого был присоединенCustomAudience
(с помощьюjoinCustomAudience
илиfetchAndJoinCustomAudience
). - Согласие на рекламу, предлагаемую приложением, включено.
Включить команды оболочки рекламных служб
- Перезагрузите устройство, чтобы завершить процесс
adservices
. - Убедитесь, что
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.