歸因報表偵錯作業的第 1 部分 (共 3 部分)。瞭解偵錯的重要性，以及在測試中使用偵錯報表的時機。
需要偵錯報表的原因
測試 Attribution Reporting API 時，建議您檢查整合作業是否正常運作、瞭解以 Cookie 為基礎的導入作業與歸因報表導入作業之間的評估結果有落差，並排解整合相關問題。
需要偵錯報表才能完成這些工作。因此，我們極力建議您設定。
詞彙
偵錯報表的重要面向
兩種偵錯報表
提供兩種偵錯報表。請同時採用這兩種做法，因為兩者可滿足不同的用途。
成功偵錯報表
成功偵錯報表會追蹤成功產生歸因報表，與歸因報表直接相關。
成功偵錯報表是從 Chrome 101 (2022 年 4 月) 起開始提供。
詳細偵錯報表
詳細偵錯報表可讓您進一步瞭解來源和觸發事件，藉此確保來源已成功登錄，或是追蹤缺少的報表並判斷缺少這些報表的原因 (來源或觸發事件發生錯誤、傳送或產生報表失敗)。 詳細偵錯報表會指出：
- 瀏覽器成功登錄來源的情況。
- 瀏覽器「未」成功登錄來源或觸發事件的情況，表示瀏覽器不會產生歸因報表。
- 因故無法產生或傳送歸因報表的情況。
詳細偵錯報表包含的 type 欄位，當中會說明來源登錄成功或無法產生來源、觸發條件或歸因報表的原因。
自 Chrome 109 (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 部分：偵錯教戰手冊」。
使用可匯總報表進行本機測試
與加密的可匯總歸因報表不同，可匯總偵錯報表包含未加密的酬載。
使用可匯總偵錯報表來驗證可匯總報表的內容，並使用本機匯總工具產生摘要報表以進行測試。
重新處理匯總服務報告
使用偵錯模式的另一個好處是，您可以再次處理報表。因此，請務必啟用偵錯報表，以便多次處理報表。建議您在下列情況中重新處理報表：
- 系統在嘗試對匯總服務進行偵錯。
- 以便實驗不同的批次處理策略
- 我們會用不同的 ε 值進行實驗
資料復原
我們建議廣告技術啟用偵錯模式來接收偵錯報表，以便復原報表資料。這對於匯總服務問題 (例如無法使用或無回應服務) 的問題，可能會導致摘要報表產生失敗。