排查 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 下选择“出价方出价阶段开始”。](https://developers.google.cn/static/privacy-sandbox/assets/images/devtools-chrome-canary-57f5cd39d92c7.png?authuser=2&hl=hr)
当断点触发时,系统会在 Worklet 脚本顶层的第一个语句之前暂停执行。您可以使用常规断点或步骤命令访问出价/评分/报告函数本身。
实时 Worklet 脚本也会显示在“Threads”面板下。
![Chrome Canary 版中开发者工具的屏幕截图,突出显示了“Sources”面板中的“Threads”窗格,显示了当前已暂停的 Worklet 脚本。](https://developers.google.cn/static/privacy-sandbox/assets/images/screenshot-devtools-chr-1d07626da18cc.png?authuser=2&hl=hr)
由于某些 Worklet 可能会并行运行,因此多个线程可能最终处于“paused”状态。您可以使用线程列表在线程之间切换,并酌情恢复或检查线程。
观察事件
在 Chrome 开发者工具中的“应用”面板中,您可以观察 Protected Audience API 兴趣群体和竞价事件。
如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示广告客户网站,则开发者工具会显示有关 join
事件的信息。
![显示 Protected Audience API 兴趣群体加入事件相关信息的开发者工具 Application 面板。](https://developers.google.cn/static/privacy-sandbox/assets/images/the-devtools-application-2d2a069c04829.png?authuser=2&hl=hr)
现在,如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示发布商网站,开发者工具会显示有关 bid
和 win
事件的信息。
![Chrome Canary 中的“开发者工具应用”面板,显示了有关 Protected Audience API 竞价出价和胜出事件的信息。](https://developers.google.cn/static/privacy-sandbox/assets/images/the-devtools-application-557aaba0f062a.png?authuser=2&hl=hr)
所有 Protected Audience API 参考文档
以下是 API 参考指南:
- Protected Audience API 开发者指南。
- 有关 Protected Audience 兴趣群体和出价生成的广告买方指南。
- Protected Audience 广告竞价广告卖方指南。
- 关于报告竞价结果的指南
- Protected Audience 广告竞价延迟时间方面的最佳实践
- 对 Protected Audience 进行问题排查
Protected Audience API 说明信息还详细介绍了功能支持和限制条件。
后续操作
我们希望与您交流,确保我们构建适合所有人的 API。
讨论 API
与其他 Privacy Sandbox API 一样,此 API 也会记录在案并公开讨论。
使用 API 进行实验
您可以进行实验并参与有关 Protected Audience API 的对话。