排查 Protected Audience API 问题

排查 Worklet 问题并观察 Protected Audience API 事件。

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

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

Protected Audience API Worklet

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

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

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

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

Chrome Canary 版中开发者工具的屏幕截图,突出显示了“Sources”面板中的“Threads”窗格,显示了当前已暂停的 Worklet 脚本。

由于某些 Worklet 可能会并行运行,因此多个线程可能最终处于“paused”状态。您可以使用线程列表在线程之间切换,并酌情恢复或检查线程。

观察事件

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

如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示广告客户网站,则开发者工具会显示有关 join 事件的信息。

显示 Protected Audience API 兴趣群体加入事件相关信息的开发者工具 Application 面板。

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

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

所有 Protected Audience API 参考文档

以下是 API 参考指南:

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

后续操作

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

讨论 API

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

使用 API 进行实验

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