關於偵錯 Attribution Reporting 的 3 部曲第 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 值。
資料復原
建議廣告技術人員啟用偵錯模式，以便接收偵錯報表，進而復原報表資料。這項功能在匯總服務發生問題時非常實用，例如服務無法使用或未回應，可能導致產生摘要報表失敗。