ウェブ版 Topics API のサポート リソース

ウェブ上のトピックのデバッグ、トラブルシューティング、サポート リソースに関する推奨事項を確認する。

トラブルシューティング

ヘッダー Sec-Browsing-Topics を設定して document.browsingTopics() 呼び出しまたは fetch() リクエストを実行しても、レスポンスとして空の配列が返される場合は、ローカル開発環境と本番環境の両方で、問題の根本原因を特定するために実施できるデバッグ手順がいくつかあります。

ローカルでデバッグする

ローカルでテストする場合は、必要なパラメータを使用して Chrome を実行していることを確認してください。

  • 登録をバイパスするには、フラグ chrome://flags/#privacy-sandbox-enrollment-overrides を有効にして、Topics を呼び出すサイトの URL を追加します。

  • フィーチャー トグルを使用して、テスト用に Topics API を構成します。これらのフラグを使用すると、エポックの長さや上位トピックの数などのパラメータを変更して、Topics を簡単にテストできます。推奨される次の機能フラグを使用できます。

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

  • フラグを使用して Chrome を実行する前に、他のすべての Chrome インスタンスとプロセスを閉じていることを確認してください。

  • 次の点をご確認ください。

    • Chrome 101 以降を使用している。
    • スクリプトが Topics API を呼び出してトピックをオブザーバーしています。テストでは、スクリプトが埋め込まれているサイトにアクセスして、ユーザーの行動をシミュレートできます。実際の例については、デモをご覧ください。
    • アドブロックや同様のアプリや拡張機能が実行されていない。
    • シークレット モードになっていないこと。
    • chrome://settings/trackingProtection 以降、Block all third-party cookies オプションは無効になります。

ライブ実装をデバッグする

ユーザーの観察から 1 週間以内に、本番環境のアプリから Topics API を呼び出す場合、アプリでユーザーのトピックがまだ観察されていない可能性があるため、結果は空になります。推奨事項に沿ってソリューションをデバッグできます。

  • サイトがプライバシー サンドボックスに登録されていることを確認します。
  • フロントエンド コードをテストして、JavaScript が想定どおりに動作することを確認します。
  • バックエンドをテストしてトピックの結果を取得します。
    • データ型とバックエンド API パラメータが正しく設定されていることを確認してください。
    • バックエンドが適切にスケーリングするように構成されていることを確認します。
  • これまでの経験から、より関連性の高いトピックの結果が得られるまでには、少なくとも 3 週間かかることが分かっています。
  • すべてのユーザーがトピックを有効にできるわけではありません。
    • ユーザーは Topics API を明示的に無効にできます。
    • パブリッシャーのページでは、権限に関するポリシーを管理し、サイトをオプトアウトできます。
  • この環境に指標とオブザーバビリティを追加します。最初の結果を分析するにはこれらが必要になります。指標の例:
    • 呼び出しのレイテンシ。
    • トピック呼び出しでの HTTP エラー。
  • 最初の 3 週間は、実装への変更を最小限に抑えるようにしてください。

リソース