デバッグのクックブック

このクックブックでは、パート 1: デバッグレポートの概要で説明したさまざまなユースケースでデバッグレポートを使用する方法について説明します。

# 使用方法: 統合をリアルタイムで確認する

1. 成功デバッグレポートを生成するようにシステムをセットアップします。方法については、パート 2: デバッグレポートのセットアップをご覧ください。
2. Attribution Reporting コードをデプロイするときは必ず、エンドポイントで成功デバッグレポートを受信しているかどうかをリアルタイムで確認します。受信していれば、アトリビューション レポートのセットアップが機能していることになります。
3. 成功デバッグレポートは、変換が行われたときにのみ送信されますが、代わりに、変換に関係なく統合が適切にセットアップされていることを確認したい場合があります。つまり、ソースが正常に登録されていることを確認したい場合です。これには、ソース登録成功の詳細デバッグレポートを利用できます。セットアップ方法については、「パート 2: デバッグ レポートのセットアップ」をご覧ください。

# 使用方法: 損失を分析し、統合のトラブルシューティングを行う

Cookie ベースのコンバージョン測定結果を Attribution Reporting レポートと比較するには、デバッグキーを使用し、Cookie コンバージョンをデバッグレポートにマッピングします。デバッグレポートはエンドポイントにすぐに送信されることに注意してください。

# 概要

デバッグキー（<source_debug_key, trigger_debug_key> ペア）を使用して、Cookie のコンバージョンを成功デバッグレポートにマッピングします。各 Cookie のコンバージョンについて、コンバージョン時に、対応する成功デバッグレポートを受け取りましたか？

受け取った場合: これらすべての成功デバッグレポートについて、いくつかの例外を除き、後でアトリビューション レポートを受け取ることができます。詳細については、成功デバッグレポートのシナリオを確認してください。

受け取らなかった場合: これは、コンバージョンがアトリビューション レポートに登録されなかったことを意味します。<source_debug_key, trigger_debug_key> ペア（トリガーデバッグキーがない場合はソースデバッグ キー）を使用して、Cookie のコンバージョンを詳細デバッグレポートにマッピングします。これらのコンバージョンのそれぞれについて、ある時点（ソースまたはトリガー時間）で、対応する詳細デバッグレポートを受け取りましたか？

• 詳細デバッグレポートを受け取らなかった場合: これは、ユーザーの動作または統合の問題が原因である可能性があります。詳細については、デバッグレポートなしのシナリオを確認してください。

• 詳細デバッグレポートを受け取った場合は、その type フィールドを確認します。

  • type が source-success である場合: ソースは正常に登録されましたが、トリガーは登録されなかったことを意味します。成功デバッグレポートが欠落している理由を絞り込むには、トリガー側の問題を示す他のタイプの対応する詳細デバッグレポートを探します。

  • 上記以外の type である場合: ソースまたはトリガーは登録されていません。type にはその理由が示されています。対応するアトリビューション レポート（および成功デバッグでポート）が欠落しています。詳細デバッグレポートの type によっては、この情報を損失分析データポイントとして取得したい（つまり、対処しない）場合もあれば、バグを報告したり、実装のトラブルシューティングを行ったりする場合もあります。詳細については、詳細デバッグレポートのシナリオをご覧ください。

# 考えられるシナリオ

# 成功デバッグレポート

特定の Cookie コンバージョンについて、成功デバッグレポートを受け取った場合、これは、このコンバージョンがアトリビューション レポートに正常に登録されたことを意味します。

いくつかの例外を除いて、このコンバージョンのアトリビューション レポートを後で受け取ることができます。

• ユーザーの行動: コンバージョン後、アトリビューション レポートが送信される前にデータを消去した、ブラウザを閉じたなど。コンバージョン後にユーザーがブラウザを閉じ、その後 1 週間ブラウザを起動しなかった場合、レポートは 1 週間以上送信されません。この遅延は損失と見なすことができます。
• イベントレベルのみに適用: イベントレベルのレポートは、優先度の高い別のレポートに置き換えられます。
• 潜在的なネットワークの問題。

# source-success タイプの詳細デバッグレポート

特定の Cookie コンバージョンのソースについて、source-success タイプの詳細デバッグレポートを受け取った場合、これはソースの登録が成功したことを意味します。トリガー登録も後で成功するかどうかによって、そのコンバージョンのレポートを受け取る場合と受け取らない場合があります。

これには、注意事項が 1 つあります。

# 上記以外のタイプの詳細デバッグレポート

特定の Cookie コンバージョンについて、詳細デバッグレポートを受け取った場合、成功デバッグレポートを受け取らないため、後でアトリビューション レポートも生成されません。これは報告可能なエラーが発生したことを意味します。ソースの登録、トリガーの登録、レポートの生成、またはレポートの送信が何らかの原因で妨げられています。以下のような原因が考えられます。

• プライバシーの制限
• 保管制限
• カスタムルール
• コードの実装の問題
• ブラウザのバグ

こういった原因はよくあることです！どのように対処するかは、各詳細レポートの type によって異なります。詳細レポートのリファレンスを確認してください。

# デバッグレポートなし

特定の Cookie コンバージョンについて、アトリビューション レポートのみを受信した場合（成功デバッグレポートも詳細デバッグレポートも受信しなかった）、これは何らかの理由でデバッグレポートの生成が妨げられたことを意味します。以下のような原因が考えられます。

• ユーザーの設定（ユーザーがサードパーティ Cookie をオフにしている）
• Cookie が見つからない、またはデバッグキーが見つからない（Cookie が欠落されているためデバッグキーが消去された）。chrome://attribution-internals で Logs タブを開き、問題が発生していないかどうかを確認します。
• アトリビューション レポートの送信時ではなく、ソースまたはトリガー時にネットワークの問題が発生した。

アトリビューション レポートを受け取っていますか？

これは、デバッグレポートを受信していない場合のケースです。特定の Cookie コンバージョンについて、いかなるタイプのレポートも受信しなかった場合（いかなるタイプのデバッグレポートもアトリビューション レポートも受信しなかった）、これは報告不可能なエラーが発生したことを意味します。以下のような原因が考えられます。

• 基本的な統合の問題。この問題をトラブルシューティングする方法について、基本的な統合の問題を解決するをご覧ください。
• 潜在的なネットワークの問題。
• ブラウザ設定のユーザー設定（プライバシーサンドボックスがオフになっている、ユーザーのブラウザでオリジントライアルが有効になっていない、など）。

# 詳細デバッグレポートのリファレンス

それぞれの詳細デバッグレポートには、対応するアトリビューション レポートがドロップされた理由を取得する type フィールドがあります。リファレンスを使用して、詳細レポートの type ごとに、対処方法を判断してください。

# ソース登録成功

ソースは正常に登録されています。

source-success: 詳細とレポート本文

# プライバシー制限レポート

**以下のレポートが期待されます。**これらは、サイト間のユーザー ID の漏えいを抑制するためのプライバシー制限を示しています。

source-destination-limit: 詳細とレポート本文

source-noised: 詳細とレポート本文

trigger-attributions-per-source-destination-limit: 詳細とレポート本文

trigger-reporting-origin-limit: 詳細とレポート本文

trigger-event-noise: 詳細とレポート本文

trigger-event-excessive-reports: レポート数が制限を超えた場合に生成されます。ビューに対して最大 1 つのコンバージョン、クリックに対して最大 3 つのコンバージョンを登録できます。優先順位を設定すれば、どのレポートを受け取るかを構成できます。詳細とレポート本文

# ストレージ制限レポート

**こ以下のレポートが期待されます。**これらは、過度のリソース使用を防ぐためのストレージ制限を示しています。

source-storage-limit: 詳細とレポート本文

trigger-event-storage-limit: 詳細とレポート本文

trigger-aggregate-storage-limit: 詳細とレポート本文

# カスタムルールレポート

以下のレポートは、フィルタリング、重複排除、優先度、またはウィンドウベースのフィルタリングを使用している場合に期待されます。念のため、対応するカスタムルールを再確認して、その詳細レポートに対応するレポートが実際に削除したいレポートであることを確認してください。これが正しければ、何もする必要はありません。

trigger-no-matching-filter-data: 詳細とレポート本文

trigger-event-no-matching-configuration: 詳細とレポート本文

trigger-event-deduplicated: 詳細とレポート本文

trigger-aggregate-deduplicated: 詳細とレポート本文

trigger-event-low-priority: 詳細とレポート本文

trigger-event-report-window-passed: 詳細とレポート本文

trigger-aggregate-report-window-passed: 詳細とレポート本文

# その他の詳細レポート

以下のレポートは、コードの潜在的な実装の問題を示している可能性があります。

trigger-no-matching-source: これは実装の問題である可能性があります。<reporting origin, destination> の構成に誤りがないことを確認してください。これも期待される API の動作である可能性があります。たとえば、ユーザーが広告を操作した後、コンバージョンに至る前のある時点でデータを消去した場合や、ユーザーが関連付けられた広告をまったく表示せずにコンバージョンに至った場合などです。詳細とレポート本文

trigger-aggregate-no-contributions: これは、コードに意図した動作ではない可能性があります。トリガー登録コードをトラブルシューティングします。コントリビューションの構成が正しいことを確認してください。詳細とレポート本文

trigger-aggregate-insufficient-budget: これは、コードに意図した動作ではない可能性があります。トリガー登録コードを再確認して、すべてのコントリビューションの合計がコントリビューションの予算を超えていないことを確認してください。詳細とレポート本文

# 予期しないエラー（潜在的なブラウザのバグ）

以下のレポートは想定外のレポートです。ブラウザのバグが原因である可能性があります。バグを報告し、説明にこの問題を再現する手順を示してください。

source-unknown-error: 詳細とレポート本文

trigger-unknown-error: 詳細とレポート本文