Protected Audience API のトラブルシューティング

ワークレットのトラブルシューティングを行い、Protected Audience API イベントをモニタリングする。

Chrome Canary 98.0.4718.0 以降では、Chrome DevTools で Protected Audience API と Protected Audience API ワークレットをデバッグできます。

Protected Audience API のライフサイクル全体については、デベロッパー ガイドをご覧ください。デベロッパーでない場合は、Protected Audience API の概要を参照してください。

Protected Audience API ワークレット

まず、[ソース] パネルの [イベント リスナーのブレークポイント] ペインで新しいカテゴリを使用してブレークポイントを設定します。

Chrome Canary のデベロッパー ツール。[ソース] パネルの [イベント リスナー ブレークポイント] ペインがハイライト表示されています。広告オークション ワークレットで [ビッダーの入札フェーズの開始] が選択されている。

ブレークポイントがトリガーされると、ワークレット スクリプトの最上位レベルの最初のステートメントの前に実行が停止します。通常のブレークポイントまたはステップ コマンドを使用して、入札/スコアリング/レポート関数自体に移動できます。

ライブ ワークレット スクリプトも [スレッド] パネルに表示されます。

Chrome Canary のデベロッパー ツールのスクリーンショット。[ソース] パネルの [スレッド] ペインがハイライト表示されており、一時停止されている現在のワークレット スクリプトが表示されています。

一部のワークレットは並列で実行されるため、複数のスレッドが「一時停止」状態になることがあります。スレッドリストを使用してスレッドを切り替え、必要に応じてスレッドを再開または詳細に検査できます。

イベントをモニタリングする

Chrome DevTools の [Application] パネルで、Protected Audience API インタレスト グループとオークション イベントをモニタリングできます。

Protected Audience API が有効になっているブラウザで Protected Audience API デモ広告主サイトにアクセスすると、DevTools に join イベントに関する情報が表示されます。

Protected Audience API のインタレスト グループの参加イベントに関する情報を表示する DevTools の [Application] パネル。

Protected Audience API が有効になっているブラウザで Protected Audience API デモ パブリッシャー サイトにアクセスすると、DevTools に bid イベントと win イベントに関する情報が表示されます。

Chrome Canary の DevTools の [Application] パネル。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.