排查 Protected Audience API 问题

排查工作流问题并观察 Protected Audience API 事件。

从 Chrome Canary 98.0.4718.0 开始,您可以在 Chrome 开发者工具中调试 Protected Audience API 和 Protected Audience API 工作件。

如需了解 Protected Audience API 的整个生命周期,请参阅开发者指南。 不是开发者?请参阅 Protected Audience API 概览

Protected Audience API worklet

第一步是在 Sources 面板的 Event Listener Breakpoints 窗格中通过新类别设置断点。

Chrome Canary 中的开发者工具,突出显示了“Sources”面板中的“Event Listener Breakpoints”窗格。在广告竞价工作流中选择“出价方出价阶段开始”。

当断点触发时,系统会在 worklet 脚本顶级的第一个语句之前暂停执行。您可以使用常规断点或步进命令来访问出价/评分/报告函数本身。

实时 Worklet 脚本也会显示在“线程”面板下。

Chrome Canary 中 DevTools 的屏幕截图,突出显示了“Sources”(来源)面板中的“Threads”(线程)窗格,其中显示了已暂停的当前 Worklet 脚本。

由于某些 worklet 可能会并行运行,因此多个线程可能会最终处于“暂停”状态。您可以使用线程列表在线程之间切换,并根据需要恢复或更仔细地检查线程。

监控事件

在 Chrome 开发者工具的“应用”面板中,您可以观察 Protected Audience API 兴趣群体和竞价事件。

如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示广告客户网站,DevTools 将显示有关 join 事件的信息。

显示 Protected Audience API 兴趣群体加入事件相关信息的 DevTools 应用面板。

现在,如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示版发布商网站,DevTools 会显示有关 bidwin 事件的信息。

Chrome Canary 中的“开发者工具”应用面板,显示有关 Protected Audience API 竞价出价和胜出事件的信息。

所有 Protected Audience API 参考文档

以下是 API 参考指南:

Protected Audience API 说明信息还详细介绍了功能支持和限制条件。

后续操作

我们希望与您交流,确保我们构建适合所有人的 API。

讨论 API

与其他 Privacy Sandbox API 一样,此 API 也会记录在案并公开讨论

使用 API 进行实验

您可以进行实验并参与有关 Protected Audience API 的对话。