排查工作流问题并观察 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”窗格。在广告竞价工作流中选择“出价方出价阶段开始”。](https://developers.google.cn/static/privacy-sandbox/assets/images/devtools-chrome-canary-57f5cd39d92c7.png?hl=fi)
当断点触发时,系统会在 worklet 脚本顶级的第一个语句之前暂停执行。您可以使用常规断点或步进命令来访问出价/评分/报告函数本身。
实时 Worklet 脚本也会显示在“线程”面板下。
![Chrome Canary 中 DevTools 的屏幕截图,突出显示了“Sources”(来源)面板中的“Threads”(线程)窗格,其中显示了已暂停的当前 Worklet 脚本。](https://developers.google.cn/static/privacy-sandbox/assets/images/screenshot-devtools-chr-1d07626da18cc.png?hl=fi)
由于某些 worklet 可能会并行运行,因此多个线程可能会最终处于“暂停”状态。您可以使用线程列表在线程之间切换,并根据需要恢复或更仔细地检查线程。
监控事件
在 Chrome 开发者工具的“应用”面板中,您可以观察 Protected Audience API 兴趣群体和竞价事件。
如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示广告客户网站,DevTools 将显示有关 join
事件的信息。
![显示 Protected Audience API 兴趣群体加入事件相关信息的 DevTools 应用面板。](https://developers.google.cn/static/privacy-sandbox/assets/images/the-devtools-application-2d2a069c04829.png?hl=fi)
现在,如果您在启用了 Protected Audience API 的浏览器中访问 Protected Audience API 演示版发布商网站,DevTools 会显示有关 bid
和 win
事件的信息。
![Chrome Canary 中的“开发者工具”应用面板,显示有关 Protected Audience API 竞价出价和胜出事件的信息。](https://developers.google.cn/static/privacy-sandbox/assets/images/the-devtools-application-557aaba0f062a.png?hl=fi)
所有 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 的对话。