Protected Audience 提供了一系列 API,用于加入和退出自定义受众群体(作为 android.adservices.customaudience 软件包的一部分)。为便于调试,提供了用于列出和查看自定义受众群体的 CLI 命令。本指南概述了广告技术开发者在检查已加入的自定义受众群体的状态时需要执行的步骤。
设置
出于安全和隐私原因,默认情况下自定义受众群体不会显示,您只能出于调试目的直接进行检查。只有在满足以下要求时,这些命令才会显示:
- 系统级开发者选项已启用
android:debuggable="true"
在从中联接CustomAudience
的应用的 AndroidManifest.xml 文件中声明(使用joinCustomAudience
或fetchAndJoinCustomAudience
)- 已开启“就应用建议的广告征求用户意见”
启用 adservices shell 命令
- 重启设备以终止
adservices
进程。 - 确认
adservices
未运行。以下命令的输出应为空。
adb shell ps -A | grep adservices
然后,如需启用 adservices
shell 命令,请运行以下命令:
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>
输出将是包含 custom_audiences
数组的 JSON 对象。此数组中元素的结构与下文所述的“查看自定义受众群体”命令的输出一致。
查看特定的自定义受众群体
如需查看特定的自定义受众群体,请运行以下命令,并将 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.