ワークレットのトラブルシューティングを行い、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 ワークレット
まず、[Sources] パネルの [Event Listener Breakpoints] ペインの新しいカテゴリからブレークポイントを設定します。
![Chrome Canary の DevTools。[Sources] パネルで [Event Listener Breakpoints] ペインがハイライト表示されています。[ビッダーの入札フェーズの開始] は広告オークションのワークレットで選択します。](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/devtools-chrome-canary-57f5cd39d92c7.png?authuser=6&hl=ja)
ブレークポイントがトリガーされると、ワークレット スクリプトの最上位にある最初のステートメントの前に実行が一時停止します。通常のブレークポイントまたはステップ コマンドを使用して、入札、スコア、レポートの関数自体にアクセスできます。
ライブ ワークレット スクリプトも [Threads] パネルに表示されます。
![Chrome Canary の DevTools のスクリーンショット。[Sources] パネルの [Threads] ペインがハイライト表示され、一時停止された現在のワークレット スクリプトが示されています。](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/screenshot-devtools-chr-1d07626da18cc.png?authuser=6&hl=ja)
一部のワークレットは並行して実行されるため、複数のスレッドが「一時停止」状態になる可能性があります。スレッドリストを使用してスレッドを切り替え、必要に応じて再開または詳細に検査できます。
イベントの監視
Chrome DevTools の [Applications] パネルで、Protected Audience API のインタレスト グループとオークション イベントを確認できます。
Protected Audience API が有効になっているブラウザで Protected Audience API のデモ広告主サイトにアクセスすると、DevTools に join
イベントに関する情報が表示されます。
![Protected Audience API インタレスト グループ参加イベントに関する情報が表示されている DevTools の [Application] パネル。](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/the-devtools-application-2d2a069c04829.png?authuser=6&hl=ja)
これで、Protected Audience API が有効になっているブラウザで Protected Audience API デモパブリッシャー サイトにアクセスすると、DevTools に bid
イベントと win
イベントに関する情報が表示されます。
![Chrome Canary の DevTools の [Application] パネル。Protected Audience API のオークション入札と落札イベントに関する情報が表示されている。](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/the-devtools-application-557aaba0f062a.png?authuser=6&hl=ja)
すべての Protected Audience API リファレンス
API リファレンス ガイドが提供されています。
- Protected Audience API のデベロッパー ガイド。
- Protected Audience のインタレスト グループと入札の生成に関する広告購入者向けガイド。
- Protected Audience の広告オークションに関する広告販売者向けガイド。
- オークション結果のレポートに関するガイド
- Protected Audience の広告オークションの遅延に関するベスト プラクティス
- Protected Audience のトラブルシューティング
Protected Audience API の解説では、機能のサポートと制約に関する詳細も説明しています。
次のステップ
誰もが利用できる API を構築するために、Google は皆様との対話を通じてしたいと考えています。
API についてディスカッションする
他のプライバシー サンドボックス API と同様に、この API はドキュメント化され、一般公開されているです。
API を試す
Protected Audience API に関する会話をテストして参加できます。