Protected Audience 提供了一系列 API,用于联接和退出自定义 受众群体(作为 android.adservices.customaudience 软件包的一部分)。对于 还有一些 CLI 命令可用于列出和查看 自定义受众群体本指南概述了广告技术开发者需要执行的步骤 检查加入的自定义受众群体的状态。
设置
出于安全和隐私方面的考虑,默认情况下,系统不会显示自定义受众群体 并且只能出于调试目的直接进行检查。它们仅可见 使用以下命令:
- 系统级开发者选项已启用
android:debuggable="true"
是在CustomAudience
加入时所在的应用(使用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.