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

Protected Audience 提供了一系列 API，用于加入和退出自定义受众群体，这些 API 属于 android.adservices.customaudience 软件包。为了便于调试，您可以使用 CLI 命令列出和查看自定义受众群体。本指南概述了广告技术开发者需要遵循的步骤，以检查其加入的自定义受众群体的状态。

设置

出于安全和隐私方面的考虑，自定义受众群体默认处于不可见状态，只能直接检查以进行调试。只有在满足以下要求时，才能使用这些命令查看它们：

  • 已启用系统级开发者选项
  • android:debuggable="true" 在应用（CustomAudience 从该应用加入）的 AndroidManifest.xml 文件中声明（使用 joinCustomAudience 或 fetchAndJoinCustomAudience）
  • “应用建议的广告”的同意设置已开启

启用 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.