歸因報表偵錯作業的第 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 轉換，您收到成功偵錯報表，就表示這個轉換已成功透過 Attribution Reporting 登錄。
您之後應該會收到這項轉換的歸因報表⏤，但有些例外：
- 使用者行為：在使用者轉換後和歸因報表傳送前清除資料、關閉瀏覽器等。如果使用者在轉換後關閉瀏覽器，而且未在一週內開啟瀏覽器，報表就不會傳送一週以上的時間。您可以將此延遲視為損失。
- 僅適用於事件層級：事件層級報表會由其他優先順序較高的報表取代。
- 可能的網路問題。
「source-success」類型的詳細偵錯報表
如果是指定 Cookie 轉換的來源，您收到了 source-success 類型的詳細偵錯報表，就表示來源登錄成功。至於之後是否登錄觸發事件，您不一定會收到該轉換的報表。
這裡有一個需要注意的事項：
任何其他類型的詳細偵錯報表
如有特定的 Cookie 轉換，您收到了任何其他類型的詳細偵錯報表，您將不會收到成功偵錯報表，因此之後也沒有歸因報表⏤，因為詳細報表意味著發生了可列入報表的錯誤。某些問題會造成來源登錄、觸發條件登錄、產生報表或報表傳送作業中斷。可能原因：
- 隱私權限制
- 儲存空間上限
- 自訂規則
- 程式碼中的實作問題
- 瀏覽器錯誤
其中有些是正常現象！應採取的行動取決於每份詳細報表的 type。查看詳細報告參考資料。
沒有偵錯報表
如有指定的 Cookie 轉換，您只收到歸因報表 (沒有成功偵錯報表或詳細偵錯報表)，就表示系統無法產生偵錯報表。可能原因：
- 使用者偏好設定 (使用者已關閉第三方 Cookie)
- Cookie 遺失或缺少偵錯金鑰 (因缺少 Cookie 而已清除偵錯金鑰)。在
chrome://attribution-internals中開啟「記錄檔」分頁，查看當中是否出現任何問題。 - 來源或觸發時間發生的網路問題，但傳送歸因報表時除外。
您是否會收到歸因報表？
也就是沒有收到偵錯報表的第二種情況：如果有某個 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- 如果報表數量超出上限，就會產生這項指標。觀看次數最多只能記錄一次轉換，點擊最多則可記錄 3 次轉換。請注意，您可以設定優先順序，指定要接收哪些報表。 詳細資料和報表內文
儲存空間限制報表
這些是正常報告。值會指出儲存空間限制，以免資源用量過大。
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 型轉換時，請找出與這個 Cookie 型轉換具有相同的 <source_debug_key, trigger_debug_key> 配對組合的成功偵錯報表 (立即傳送)。
假設您收到了這 70 筆 Cookie 轉換的成功偵錯報表。
- 成功報表表示歸因已成功記錄，因此您可以放心假設您會收到與每份成功報表對應的歸因報表，但有些例外。
- 您可以決定監控這些例外狀況。為了這麼做，由於歸因報表會在未來幾天/週 (視到期時間而定) 傳送至端點，請找出與各成功偵錯報表具有相同偵錯金鑰組合的歸因報表。請務必耐心等候，因為系統不會在每個視窗結束時立即傳送報表。假設您只找到 60 份歸因報表。這 10 份缺少歸因報表的原因可能是使用者行為。
步驟 3：短暫損失評估
100-70 = 缺少 30 份成功的偵錯報表。也就是說，「歸因報表」不會記錄這 30 次轉換 (在導入 Cookie 時追蹤)。但不會收到這些項目的歸因報表。
由於您擁有 100 個 Cookie 轉換，且只有 70 次歸因型轉換，因此錯失的 30%。您現在完成了簡短的損失評估。
步驟 4：分析原因
如要調查缺少這些報表的原因，請找出轉換 (觸發事件登錄) 時間或更早在來源登錄時收到的對應詳細偵錯報表。使用 Cookie 型轉換的金鑰，將這些轉換對應至詳細偵錯報表。
- 假設有 10 個鍵，但沒有詳細偵錯報表。檢查是否有任何整合問題。如果不是的話，原因可能是使用者行為。
- 您有 20 份詳細偵錯報表。您現在可以修正損失分析的範圍。分析每份詳細報表的
type欄位。舉例來說，你可能會發現：- 10 (在我們的範例中為 10%) 報表因為
pending destination limit而缺少部分資料 - 因
trigger-aggregate-no-contributions而缺少 5 份 (= 5%) 的報表。 - 因
unknown-error而缺少 5 份 (= 5%) 的報表。
- 10 (在我們的範例中為 10%) 報表因為
步驟 5：採取行動並排解問題
瞭解報表遺漏的原因後，您就可以根據這些深入分析採取行動。
應採取的行動取決於每份詳細報表的 type。詳情請參閱詳細報表參考資料。例如：
- 「
pending-destination-limit」是隱私保護服務，您無須採取任何行動。您可以利用這個數字當做資料點，掌握及監控情況。 trigger-aggregate-no-contributions可能代表您有導入問題，進一步分析。請使用詳細報表內文中的詳細資料進行疑難排解，並視情況修正。unknown-error可能是瀏覽器發生錯誤或網路錯誤的徵兆。如果您重複遇到這個問題，請向瀏覽器開發人員回報錯誤。