在命令行中检查自定义受众群体

Protected Audience 提供了一系列 API,用于加入和退出自定义受众群体(作为 android.adservices.customaudience 软件包的一部分)。为便于调试,提供了用于列出和查看自定义受众群体的 CLI 命令。本指南概述了广告技术开发者在检查已加入的自定义受众群体的状态时需要执行的步骤。

设置

出于安全和隐私原因,默认情况下自定义受众群体不会显示,您只能出于调试目的直接进行检查。只有在满足以下要求时,这些命令才会显示:

  • 系统级开发者选项已启用
  • android:debuggable="true" 在从中联接 CustomAudience 的应用的 AndroidManifest.xml 文件中声明(使用 joinCustomAudiencefetchAndJoinCustomAudience
  • 已开启“就应用建议的广告征求用户意见”

启用 adservices shell 命令

  1. 重启设备以终止 adservices 进程。
  2. 确认 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.