這是歸因報表偵錯作業的第 1 部分，瞭解偵錯的重要性，以及在測試時使用偵錯報表的時機。
為什麼需要偵錯報表
如果您正在測試 Attribution Reporting API，請檢查整合功能是否正常運作、瞭解以 Cookie 為基礎的導入方式與 Attribution Reporting 導入方式之間的評估結果差異，並排解整合問題。
您必須提供偵錯報告，才能完成這些工作。因此，我們強烈建議您設定這些功能。
詞彙
偵錯報表的主要特色
兩種偵錯報表
偵錯報表有兩種，請同時使用這兩者，因為它們適用於不同用途。
成功偵錯報表
成功偵錯報表會追蹤歸因報表是否成功產生。與歸因報表直接相關。
自 Chrome 101 (2022 年 4 月) 起，您就能查看成功偵錯報告。
詳細偵錯報表
詳細偵錯報表可提供來源和觸發事件的詳細資訊，方便您確認來源是否已成功登錄，或追蹤遺漏的報表並找出原因 (來源或觸發事件發生錯誤，或是在傳送/產生報表時發生錯誤)。詳細偵錯報表會顯示：
- 瀏覽器成功註冊來源的案例。
- 瀏覽器未成功登錄來源或觸發事件，因此不會產生歸因報表。
- 因故無法產生或傳送歸因報表。
詳細偵錯報表包含 type 欄位，說明來源登錄是否成功，或未產生來源、觸發事件或歸因報表的原因。
自 Chrome 109 (2023 年 1 月) 起，您就能取得詳細的偵錯報告，但來源註冊成功詳細偵錯報告除外，這類報告是在 Chrome 112 中新增。
請參閱第 2 部分：設定偵錯報表中的報表範例。
偵錯報表是以 Cookie 為依據
如果設定為接收報表的來源是第三方，這個 Cookie 就會是第三方 Cookie。也就是說，只有在使用者的瀏覽器允許第三方 Cookie 時，系統才會產生偵錯報表。
立即傳送偵錯報表
瀏覽器會立即將偵錯報表傳送至報表來源。這與延遲傳送的歸因報表不同。
系統會在產生相應的歸因報表時，立即產生並傳送成功偵錯報表，也就是在登錄觸發事件時。
來源或觸發事件登錄後，系統會立即傳送詳細偵錯報表。
偵錯報表的端點路徑不同
與歸因報表相同，所有偵錯報表都會傳送至報表來源。偵錯報表會傳送至回報來源的三個不同端點：
- 事件層級成功偵錯報表的端點
- 適用於成功偵錯報表的端點，可匯總
- 詳細偵錯報表 (事件層級和可匯總) 的端點。
詳情請參閱第 2 部分：設定偵錯報表。
用途
基本即時整合檢查
偵錯報表會立即傳送至端點，不像歸因報表會延遲傳送，以保護使用者隱私權。使用偵錯報表做為即時信號，確認與 Attribution Reporting API 的整合作業正常運作。
如要瞭解如何執行這項操作，請參閱「第 3 部分：偵錯食譜」。
流失分析
與第三方 Cookie 不同，Attribution Reporting API 內建隱私權保護機制，可兼顧實用性和隱私權。也就是說，您可能無法透過 Attribution Reporting API 收集到所有評估資料，但可透過 Cookie 收集。並非所有可透過第三方 Cookie 追蹤的轉換都會產生歸因報表。
舉例來說，在事件層級報表中，您最多只能為每次曝光註冊一次轉換。也就是說，無論使用者轉換多少次，您只會收到一份特定廣告曝光的歸因報表。
您可以透過偵錯報表，瞭解以 Cookie 為準的評估結果，與使用 Attribution Reporting API 取得的結果之間有何差異。找出系統記錄的轉換、未記錄的轉換次數，以及未記錄的轉換和原因。
請參閱第 3 部分：偵錯教戰手冊，瞭解如何執行損失分析。
疑難排解
雖然隱私權或資源保護措施造成的損失是預期中的情況，但其他損失可能並非如此。導入作業中的設定錯誤或瀏覽器本身的錯誤，都可能導致報表遺失。
您可以使用偵錯報告偵測及修正導入問題，或向瀏覽器團隊回報潛在錯誤。如要瞭解如何執行這項操作，請參閱「第 3 部分：偵錯食譜」。
進階設定檢查
您可以透過 Attribution Reporting API 的部分功能，自訂 API 的行為。例如篩選規則、重複資料刪除規則和優先順序規則。
使用這些功能時，請運用偵錯報表檢查邏輯是否會在正式版中產生預期行為，不必等待歸因報表。如要瞭解如何執行這項操作，請參閱「第 3 部分：偵錯食譜」。
使用可匯總報表進行本機測試
與經過加密的可匯總歸因報表不同，可匯總偵錯報表包含未加密的酬載。
您可以使用可匯總的偵錯報表驗證可匯總報表的內容，並使用本機匯總工具產生摘要報表以進行測試。
重新處理匯總服務報表
使用偵錯模式的另一個優點是，您可以再次處理報表。因此，如要多次處理報表，請務必啟用偵錯報表。 在下列情況下，您可能需要重新處理報表：
- 嘗試對匯總服務進行偵錯。
- 實驗不同的批次處理策略。
- 測試不同的 epsilon 值。
資料復原
建議廣告技術人員啟用偵錯模式，接收偵錯報告，以便復原報表資料。如果匯總服務發生問題 (例如服務無法使用或沒有回應，導致摘要報表產生失敗)，這項功能就非常實用。