排查 Protected Audience API 问题

排查工作单元问题并观察 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 工作程序

第一步是通过来源面板中的事件监听器断点窗格中的新类别来设置断点。

Chrome Canary 中的开发者工具,突出显示了“来源”面板中的“事件监听器断点”窗格。在广告竞价工作程序下选择“出价方出价阶段开始”。

当断点触发时,执行会在工作区脚本顶层的第一条语句之前暂停。您可以使用常规断点或步进命令来进入出价/评分/报告函数本身。

实时工作单元脚本也会显示在“线程”面板下。

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

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

观测事件

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

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

显示有关 Protected Audience API 兴趣群体加入事件信息的开发者工具“应用”面板。
显示有关 Protected Audience API 兴趣群体加入事件信息的开发者工具“应用”面板。

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

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

所有 Protected Audience API 参考

API reference guides are available:

The Protected Audience API explainer also provides detail about feature support and constraints.

What's next?

We want to engage in conversations with you to ensure we build an API that works for everyone.

Discuss the API

Like other Privacy Sandbox APIs, this API is documented and discussed publicly.

Experiment with the API

You can experiment and participate in conversation about the Protected Audience API.