關於偵錯 Attribution Reporting 的 3 部曲第 3 部。查看偵錯報表的使用說明。
在本食譜中，您將找到如何針對第 1 部分：偵錯報表簡介中列出的各種用途，使用偵錯報表的操作說明。
詞彙解釋
- 報表來源是設定歸因報表來源和觸發條件標頭的來源。瀏覽器產生的所有報表都會傳送至這個來源。在本指南中，我們使用
https://adtech.example做為報表來源範例。 - 「歸因報表」 (簡稱「報表」) 是最終報表 (事件層級或可匯總)，內含您要求的評估資料。
- 偵錯報表包含歸因報表或來源/觸發事件的其他相關資料。收到偵錯報表不一定代表有運作錯誤！偵錯報表分為兩種類型
- 「轉換偵錯報表」是一種偵錯報表，需要設定 Cookie 才能產生及傳送。假如沒有設定 Cookie 且第三方 Cookie 淘汰，轉換偵錯報表將一併停止提供。本指南介紹的所有偵錯報表都是轉換偵錯報表。
- 成功偵錯報表會追蹤成功產生歸因報表。這類指標與歸因報表直接相關。成功偵錯報表自 Chrome 101 版 (2022 年 4 月) 起提供。
- 詳細偵錯報表可追蹤缺漏報表，協助您判斷為何缺少這些報表。指出瀏覽器未記錄來源或觸發事件的情況 (這表示系統不會產生歸因報表)，以及因故無法產生或傳送歸因報表的情況。詳細偵錯報表包含
type欄位，說明來源事件、觸發事件或歸因報表未產生的原因。自 Chrome 109 版開始提供詳細偵錯報表 (2023 年 1 月推出穩定版)。 - 偵錯金鑰是可在來源端和觸發端設定的專屬 ID。偵錯金鑰可讓您對應 Cookie 型轉換和歸因型轉換。設定系統產生偵錯報表並設定偵錯金鑰後，瀏覽器會將這些偵錯金鑰納入所有歸因報表和偵錯報表。
如要進一步瞭解我們說明文件中使用的更多概念和重要詞彙，請參閱「Privacy Sandbox 詞彙」。
操作說明：即時檢查整合
- 設定系統產生成功偵錯報表。請參閱第 2 部分：設定偵錯報表。
- 每次部署歸因報表程式碼時，請即時檢查端點是否收到成功的偵錯報表。如果是，表示 Attribution Reporting 設定正常運作。
- 只有在發生轉換時，系統才會傳送成功偵錯報表。因此，不論轉換是否發生，您都應檢查整合是否設定正確，也就是檢查來源是否已成功註冊。為達成這項目標，您可以使用來源註冊成功 詳細偵錯報表。如要瞭解如何設定這些項目，請參閱「第 2 部分：設定偵錯報告」。
操作說明：分析損失並排解整合問題
如要比較以 Cookie 為基礎的轉換評估結果與歸因報表，請使用偵錯金鑰，並透過偵錯報表對應 Cookie 轉換。請注意，系統會立即將偵錯報告傳送至端點。
總覽
使用偵錯金鑰 (<source_debug_key, trigger_debug_key> 組) 將 Cookie 轉換對應至成功偵錯報表。針對每個 Cookie 轉換，您是否在轉換時收到對應的成功偵錯報表？
如果是：對於所有成功的偵錯報表，您日後都會收到歸因報表，但有少數例外狀況。詳情請參閱成功的偵錯報告情境。
如果不是：表示轉換未登錄至歸因報表。使用 <source_debug_key, trigger_debug_key> 組合 (或來源偵錯金鑰，如果沒有觸發偵錯金鑰)，將 Cookie 轉換對應至詳細的偵錯報表。對於每個轉換，您是否在某個時間點 (來源或觸發時間) 收到對應的詳細偵錯報表？
如果您沒有收到詳細的偵錯報告，可能是使用者行為或整合問題造成。詳情請參閱沒有偵錯報告的情況。
如果您收到詳細的偵錯報表，請查看其
type欄位。如果
type為source-success：表示來源已成功註冊，但觸發事件未註冊。如要進一步瞭解成功偵錯報表為何缺少，請找出任何其他類型的對應詳細偵錯報表⏤，這類報表會指出觸發事件方面的問題。如果
type為其他值：表示來源或觸發事件尚未登錄。type會說明原因。對應的歸因報表 (和成功偵錯報表) 將會遺失。視詳細偵錯報表的type而定，您可能只想將這項資訊做為損失分析資料點 (也就是不採取任何行動)，或是您可能想回報錯誤或排解實作問題。詳情請參閱詳細偵錯報告情境。
可能的情況
成功偵錯報表
如果您收到特定 Cookie 轉換的成功偵錯報表，表示該轉換已成功登錄至歸因報表。
您稍後會收到這筆轉換的歸因報表⏤，但有幾種例外狀況：
- 使用者行為：在轉換後和傳送歸因報表前清除資料、關閉瀏覽器等。如果使用者在轉換後關閉瀏覽器，且一週內未再開啟瀏覽器，報表就會延遲一週或更久才傳送。您可能會將這項延遲視為損失。
- 僅適用於事件層級：事件層級報表會被其他優先順序較高的報表取代。
- 可能的網路問題。
source-success 類型的詳細偵錯報表
如果您收到 source-success 類型的詳細偵錯報表，表示來源登錄成功。視觸發事件註冊作業是否稍後成功而定，您可能會或不會收到該轉換的報表。
但這項功能有一個限制：
任何其他類型的詳細偵錯報表
如果針對特定 Cookie 轉換，您收到任何其他類型的詳細偵錯報表，就不會收到成功偵錯報表，因此之後也不會有歸因報表⏤，因為詳細報表表示發生了可記錄的失敗。發生了一些問題，導致無法註冊來源、觸發事件、產生報表或傳送報表。可能原因：
- 隱私權限制
- 儲存空間上限
- 自訂規則
- 程式碼中實作問題
- 瀏覽器錯誤
其中有些是預期的！您採取的行動取決於每份詳細報表的 type。請參閱詳細報表參考資料。
沒有偵錯報表
如果您針對特定 Cookie 轉換只收到歸因報表 (沒有成功偵錯報表或詳細偵錯報表)，表示有某些因素導致偵錯報表無法產生。可能原因：
- 使用者偏好設定 (使用者已關閉第三方 Cookie)
- 缺少 Cookie 或偵錯鍵 (偵錯鍵因缺少 Cookie 而清除)。在
chrome://attribution-internals中，開啟「Logs」分頁，檢查是否有任何問題。 - 在來源或觸發事件發生時發生網路問題，但在傳送歸因報表時並未發生。
您是否收到歸因報表？
這是未收到偵錯報表的子案例：如果您針對特定 Cookie 轉換未收到任何報表 (無任何偵錯報表、歸因報表)，表示發生了無法回報的失敗。可能原因：
- 基本整合問題。請參閱「修正基本整合問題」一文，瞭解如何排除這些問題。
- 可能的網路問題。
- 瀏覽器設定中的使用者偏好設定 (例如關閉 Privacy Sandbox)。
詳細偵錯報表參考資料
每份詳細偵錯報表都包含 type 欄位，用於記錄相應歸因報表遭到捨棄的原因。請參考這份文件，瞭解每個詳細報表的 type 需要採取哪些動作。
來源登錄成功
已成功註冊來源。
source-success- 詳細資料和報表內容
隱私權限制報表
這些報表是預期的結果。這些標記可指出隱私權限制，以減少跨網站使用者身分外洩的情形。
source-destination-limit- 詳細資料和報告內容
source-noised- 詳細資料和報告內容
trigger-attributions-per-source-destination-limit- 詳細資料和報告內容
trigger-reporting-origin-limit- 詳細資料和報告內容
trigger-event-noise- 詳細資料和報告內容
trigger-event-excessive-reports- 如果報表計數超過上限，系統就會產生這項資料。您最多只能註冊一次觀看次數轉換，以及三次點擊轉換。請注意，您可以設定優先順序，藉此調整要接收的報表。詳細資料和報告內容
儲存空間限制報表
這些報表是預期的結果。這些標記代表儲存空間限制，可避免資源過度使用。
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- 這可能不是您希望程式碼具備的行為。請仔細檢查觸發條件註冊碼，確保所有捐款總額不會超過捐款預算。詳細資料和報告內容
發生非預期的錯誤 (可能的瀏覽器錯誤)
這些報表並非預期的結果。這可能是瀏覽器錯誤所致！回報錯誤，並在說明中指定重現錯誤的步驟。
損失分析範例
步驟 1：使用 Cookie 設定及對應
請按照「第 2 部分：設定偵錯報表」中的操作說明，設定系統產生成功偵錯報表和詳細偵錯報表。
這樣一來，您就能使用 Cookie 轉換資訊查詢對應的偵錯報表或歸因報表。
步驟 2：找出成功註冊和缺少的報表
在這個範例中，假設您已透過 Cookie 系統追蹤 100 次轉換。
每次記錄 Cookie 轉換時，請找出成功偵錯報表 (立即傳送)，該報表的 <source_debug_key, trigger_debug_key> 組與 Cookie 轉換相同。
假設您已收到 70 個 Cookie 轉換的成功偵錯報表。
- 成功報表表示已成功記錄歸因資料，因此您可以放心，每份成功報表都會對應到一份歸因報表 (但有部分例外狀況)。
- 您可以選擇監控這些例外狀況。為此，請在接下來幾天/幾週內 (視到期日而定)，找出歸因報表與每份成功偵錯報表的偵錯鍵組合相同。請務必稍待片刻：報表可能不會在每個時間區間結束時立即傳送。假設您只找到 60 份歸因報表，缺少的 10 份歸因報表可能是因使用者行為所致。
步驟 3：簡要損失評估
100-70 = 30 個成功偵錯報表遺失。也就是說，這 30 筆轉換 (在以 Cookie 為基礎的導入方式中追蹤) 並未記錄在歸因報表中。您不會收到這些報表。
由於您有 100 個 Cookie 轉換，但只有 70 個歸因轉換，因此損失率為 30%。你現在可以查看簡短的損失評估結果。
步驟 4：分析原因
如要調查這些報表為何遺漏，請查看您在轉換 (觸發事件登錄) 時間或更早的來源登錄時間收到的對應詳細偵錯報表。使用 Cookie 轉換的鍵，將這些項目對應至詳細的偵錯報表。
- 假設有 10 個鍵沒有詳細的偵錯報表。檢查是否有任何整合問題。如果不是，可能是使用者行為造成。
- 您有 20 份詳細偵錯報表。您現在可以進一步分析損失。分析每份詳細報表的
type欄位。舉例來說，您可能會發現：- 由於
pending destination limit，因此缺少 10 份 (等於 10%) 報表 - 由於
trigger-aggregate-no-contributions，因此缺少 5 份 (= 5%) 報表。 - 由於
unknown-error，因此缺少 5 份 (= 5%) 報表。
- 由於
步驟 5：採取行動及排解問題
瞭解缺少報表的原因後，您可以採取行動。
您採取的行動取決於每份詳細報表的 type。詳情請參閱詳細報表參考資料。例如：
pending-destination-limit是隱私保護服務，您不需要採取任何行動。您可以將這個數字當作資料點，用於查看及監控。trigger-aggregate-no-contributions可能代表導入過程中發生問題。進一步分析。請參考詳細報表的內容，視需要排解及修正問題。unknown-error可能是瀏覽器錯誤或網路錯誤的徵兆。如果屢次遇到這個問題，請向瀏覽器開發人員回報錯誤。