アトリビューション レポートのデバッグに関するパート 1/3。デバッグが重要な理由と、テストでデバッグ レポートを使用するタイミングについて学びます。
デバッグ レポートが必要な理由
Attribution Reporting API をテストする場合 統合が正しく機能していることを確認し 2 つの期間と測定結果の差異を把握 Cookie ベースの設定とアトリビューション レポートの実装を確認して、統合に関する問題のトラブルシューティングを行ってください。
これらのタスクを完了するには、デバッグ レポートが必要です。そのため、これらを設定することを強くおすすめします。
用語集
デバッグ レポートの重要な側面
2 種類のデバッグ レポート
2 種類のデバッグ レポートを使用できます。それぞれ用途が異なるため、両方を使用してください。
成功デバッグ レポート
成功デバッグ レポートでは、アトリビューション レポートの正常な生成を追跡できます。共感を呼ぶ アトリビューションレポートに 直接移動できます
成功デバッグ レポートは、Chrome 101（2022 年 4 月）からご利用いただけます。
詳細なデバッグ レポート
詳細なデバッグ レポートでは、ソースとトリガー イベントをより詳しく把握できます。これにより、ソースが正常に登録されたことを確認することも、欠落しているレポートを追跡して欠落している理由（ソースまたはトリガー イベントの失敗、レポートの送信または生成時のエラー）を特定することもできます。 詳細なデバッグ レポートには次の情報が表示されます。
- ブラウザでソースが正常に登録されたケース。
- ブラウザでソースイベントまたはトリガー イベントが正常に登録されなかったケース（つまり、アトリビューション レポートが生成されないケース）。
- なんらかの理由でアトリビューション レポートを生成または送信できないケース。
詳細なデバッグ レポートには、ソースの登録が成功したか、ソース、トリガー、アトリビューション レポートが生成されなかった理由を示す type フィールドが含まれます。
詳細デバッグ レポートは Chrome 109（2023 年 1 月）からご利用いただけます。ただし、Chrome 112 で追加されたソース登録成功の詳細デバッグ レポートは除きます。
パート 2: デバッグ レポートを設定するで、レポートの例を確認します。
デバッグ レポートは Cookie ベースです
デバッグ レポートを使用するには、レポート送信元が Cookie を設定する必要があります。
レポートを受信するように設定されているオリジンがサードパーティである場合、この Cookie はサードパーティになります できます。これには、次のような影響があります。
- デバッグ レポートは、サードパーティ Cookie が ユーザーのブラウザで許可されている場合。
- デバッグ レポートはサードパーティ Cookie の廃止後は利用できなくなる 段階的に廃止されます。
デバッグ レポートがすぐに送信されます
デバッグ レポートは、ブラウザからレポート送信元に直ちに送信されます。この レポートに送信されるアトリビューション レポートとは異なり、 発生します。
成功を示すデバッグ レポートが生成され、 対応するアトリビューション レポートが生成される（トリガー時に） 登録できます。
詳細なデバッグ レポートがソースまたはトリガーの直後に送信 登録できます。
デバッグ レポートのエンドポイント パスが異なる
アトリビューション レポートと同様に、すべてのデバッグ レポートはレポート元に送信されます。デバッグ レポートは、レポート送信元の 3 つの異なるエンドポイントに送信されます。
- 成功デバッグ レポートのエンドポイント（イベントレベル）
- 成功デバッグ レポートのエンドポイント（集計可能）
- 詳細デバッグ レポート（イベントレベルおよび集計可能）のエンドポイント。
詳細については、パート 2: デバッグ レポートを設定するをご覧ください。
ユースケース
基本的なリアルタイム統合チェック
アトリビューション レポートとは異なり、デバッグ レポートはすぐにエンドポイントに送信されます ユーザーのプライバシーを保護するために遅延できます。デバッグ レポートを、 Attribution Reporting API が動作している。
この方法については、パート 3: デバッグ クックブックをご覧ください。
損失の分析
サードパーティ Cookie とは異なり、アトリビューション レポートは API にプライバシーが組み込まれている 利便性と有効性のバランスを取るよう設計された 説明します。つまり Attribution Reporting API では、 すべての測定データを収集して できます。獲得可能なコンバージョンがすべて アトリビューション レポートを生成します。
例: イベントレベル レポートの場合、登録できるコンバージョンは 1 つのみです。 ですつまり、特定の広告インプレッションについて、ユーザーが何回コンバージョンを達成しても、アトリビューション レポートは 1 つしか取得できません。
デバッグ レポートを使用すると、 Cookie ベースの測定結果とアトリビューションで得られる結果 Reporting APIレポートされているコンバージョンや獲得したコンバージョン数を特定する 特に報告対象とその理由を確認できます
損失分析の実行方法については、パート 3: デバッグ クックブックをご覧ください。
トラブルシューティング
プライバシーやリソースの保護に起因する損失は予想されますが、 メッセージが表示される可能性があります。実装の構成ミスや レポートが欠落している場合があります。
デバッグ レポートは、お客様側で実装の問題を検出して修正するために使用できます。または、 潜在的なバグをブラウザチームに報告します。詳しくは、 パート 3: デバッグ クックブック
高度な構成チェック
Attribution Reporting API の一部の機能を使用すると、API の サポートします。たとえば、フィルタリング ルール、重複除去ルール、優先度ルールなどがこれに該当します。
これらの機能を使用する場合は、デバッグ レポートを使用して、ロジックが アトリビューション レポートを待つ必要はありません。この方法については、パート 3: デバッグ クックブックをご覧ください。
集計可能レポートを使用したローカルテスト
暗号化された集計可能アトリビューション レポートとは異なり、集計可能デバッグ レポートは 暗号化されていないペイロードが 含まれるようになります
集計可能デバッグ レポートを使用して集計可能レポートの内容を検証する また、テスト用にローカルの集計ツールを使用して概要レポートを生成することもできます。
集計サービス レポートの再処理
デバッグモードを使用するもう一つの利点は、レポートを再度処理できることです。そのため、レポートを複数回処理するには、デバッグ レポートを有効にする必要があります。 レポートの再処理が推奨されるのは次のような場合です。
- デバッグに使用するサンプル データです。
- さまざまなバッチ処理戦略を試すことができます。
- さまざまなイプシロン値でテストします。
データ復旧
広告テクノロジーがレポートデータを復元できるように、デバッグ レポートを受信できるようにデバッグモードを有効にすることをおすすめします。これは、集計サービスの問題（サービスが使用できない、または応答しないなど）によって概要レポートの生成が失敗する場合に役立ちます。