第 1 部分 (共 3 部分)，說明如何偵錯歸因報表。瞭解偵錯的重要性，以及在測試中使用偵錯報表的時機。
需要偵錯報表的原因
如果您測試的是 Attribution Reporting API，請務必檢查整合是否正常運作、瞭解以 Cookie 為基礎的導入作業與歸因報表導入作業之間的評估結果落差，並排解整合的任何問題。
您需要偵錯報表才能完成這些工作。因此，我們極力建議您進行設定。
詞彙解釋
偵錯報表的重要面向
兩種偵錯報表
可用的偵錯報表分為兩種類型。兩種做法皆使用，因為兩者可滿足不同的用途。
成功偵錯報表
成功偵錯報表會追蹤成功產生歸因報表。這類指標與歸因報表直接相關
自 Chrome 101 (2022 年 4 月) 起，我們提供成功偵錯報表。
詳細偵錯報表
詳細偵錯報表可讓您進一步瞭解來源和觸發事件，確保來源已成功登錄，或是追蹤缺漏的報表，進而判斷缺少的原因 (來源或觸發事件失敗、傳送或產生報表失敗)。 詳細偵錯報表會指出：
- 瀏覽器成功登錄來源的情況。
- 瀏覽器「無法」成功登錄來源或觸發事件 (也就是說，瀏覽器不會產生歸因報表)。
- 因故無法產生或傳送歸因報表的情況。
詳細偵錯報表會包含 type 欄位，用於說明來源登錄成功，或是無法產生來源、觸發事件或歸因報表的原因。
Chrome 自 109 年 1 月 (2023 年 1 月) 起開始提供詳細偵錯報表，但於 Chrome 112 下半年新增的來源登錄成功詳細偵錯報表除外。
查看「第 2 部分：設定偵錯報表」中的範例報表。
偵錯報表是以 Cookie 為基礎
如果設定接收報表的來源是第三方，這個 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 值
資料復原
我們建議廣告技術啟用偵錯模式來接收偵錯報表，以便復原報表資料。這在發生匯總服務問題時 (例如服務無法使用或非回應服務)，導致摘要報表生成失敗時，這個做法就能派上用場。