排解工作小程式的問題,並觀察 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 工作
首先,請前往「Sources」(來源) 面板的「Event Listener Breakpoints」(事件監聽器中斷點) 窗格,透過新類別設定中斷點。
![Chrome Canary 中的開發人員工具,醒目顯示「來源」面板的「事件監聽器中斷點」窗格。「廣告競價工作列」中選取了「出價方出價階段開始」。](https://developers.google.cn/static/privacy-sandbox/assets/images/devtools-chrome-canary-57f5cd39d92c7.png?authuser=0000&hl=zh-tw)
當中斷點觸發時,執行作業會在 Worklet 指令碼頂層的第一個陳述式之前暫停。您可以使用一般中斷點或步驟指令來取得出價/評分/回報函式本身。
即時 Worklet 指令碼也會顯示在「Threads」面板下方。
![Chrome Canary 中開發人員工具的螢幕截圖,醒目顯示出「Source」面板中的「Threads」窗格,顯示目前暫停的 Worklet 指令碼。](https://developers.google.cn/static/privacy-sandbox/assets/images/screenshot-devtools-chr-1d07626da18cc.png?authuser=0000&hl=zh-tw)
由於某些 Worklet 可能會平行執行,因此多個執行緒可能會進入「已暫停」狀態。您可以使用執行緒清單切換執行緒,並視情況恢復或檢查執行緒。
觀察事件
您可以透過 Chrome 開發人員工具的「應用程式」面板觀察 Protected Audience API 興趣群組和競價事件。
如果您在瀏覽器中造訪 Protected Audience API 示範廣告主網站,且使用已啟用 Protected Audience API,開發人員工具就會顯示 join
事件的相關資訊。
![開發人員工具「應用程式」面板顯示 Protected Audience API 興趣群組加入事件的相關資訊。](https://developers.google.cn/static/privacy-sandbox/assets/images/the-devtools-application-2d2a069c04829.png?authuser=0000&hl=zh-tw)
現在,如果您透過已啟用 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=0000&hl=zh-tw)
所有 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 的討論。