第 1 部分 (共 3 部分),說明如何偵錯歸因報表。瞭解偵錯的重要性,以及在測試中使用偵錯報表的時機。
需要偵錯報表的原因
如要測試 Attribution Reporting API 您應檢查整合是否正常運作,並瞭解整合廣告活動之間 以 Cookie 為基礎的導入作業和歸因報表導入作業,並排解與整合相關的任何問題。
您需要偵錯報表才能完成這些工作。因此,我們極力建議您進行設定。
詞彙解釋
偵錯報表的重要面向
兩種偵錯報表
可用的偵錯報表分為兩種類型。兩種做法皆使用,因為兩者可滿足不同的用途。
成功偵錯報表
成功偵錯報表會追蹤成功產生歸因報表。這類素材資源的關聯 加入歸因報表
自 Chrome 101 (2022 年 4 月) 起,我們提供成功偵錯報表。
詳細偵錯報表
詳細偵錯報表可讓您進一步瞭解來源和觸發事件,確保來源已成功登錄,或是追蹤缺漏的報表,進而判斷缺少的原因 (例如來源或觸發事件發生錯誤、傳送或產生報表時失敗)。 詳細偵錯報表會指出:
- 瀏覽器成功登錄來源的情況。
- 瀏覽器「無法」成功登錄來源或觸發事件 (也就是說,瀏覽器不會產生歸因報表)。
- 因故無法產生或傳送歸因報表的情況。
詳細偵錯報表會包含 type
欄位,用於說明來源登錄成功,或是無法產生來源、觸發事件或歸因報表的原因。
Chrome 自 109 年 1 月 (2023 年 1 月) 起開始提供詳細偵錯報表,但於 Chrome 112 下半年新增的來源登錄成功詳細偵錯報表除外。
查看「第 2 部分:設定偵錯報表」中的範例報表。
偵錯報表是以 Cookie 為基礎
如果設定為接收報表的來源是第三方,這個 Cookie 就會是第三方 Cookie Cookie。這會帶來下列幾項關鍵影響:
- 只有在第三方 Cookie 符合以下條件的情況下,系統才會產生偵錯報表 允許存取。
- 第三方 Cookie 淘汰後,偵錯報表將不再提供。 逐步停用
偵錯報表會立即送出
瀏覽器會立即將偵錯報表傳送給報表來源。這個 有別於歸因報表,透過 延遲時間
成功偵錯報表會在 系統產生相應的歸因報表 註冊。
在來源或觸發事件時,系統會立即傳送詳細偵錯報表 註冊。
偵錯報表有不同的端點路徑
和歸因報表一樣,所有偵錯報表都會傳送至報表來源。偵錯報表會傳送到報表來源的三個不同端點:
- 成功偵錯報表的端點 (事件層級)
- 成功偵錯報表的端點 (可匯總)
- 詳細偵錯報表、事件層級和可匯總的端點。
詳情請參閱「第 2 部分:設定偵錯報表」。
用途
基本即時整合檢查
與歸因報表不同,偵錯報表會立即傳送至端點 以保護使用者隱私。使用偵錯報表做為與 Attribution Reporting API 運作正常。
如要瞭解如何執行這項作業,請參閱第 3 部分:偵錯教戰手冊。
損失分析
歸因報表與第三方 Cookie 不同 API 內建隱私權防護機制 旨在兼顧實用度和安全性 和隱私權也就是說,如果使用 Attribution Reporting API, 會收集您目前透過這項功能收集的所有評估資料 Cookie。您可能無法獲得的部分轉換 使用第三方 Cookie 追蹤會產生歸因報表。
範例:對於事件層級報表,您最多只能登錄 1 次轉換 每次曝光也就是說,無論使用者完成轉換的次數為何,您都只會收到一次廣告曝光的一份歸因報表。
透過偵錯報表瞭解 以 Cookie 為基礎的成效評估結果,以及歸因分析功能的成效 Reporting API。指明記錄到哪些轉換及轉換次數 並提供具體原因和原因
參閱第 3 部分:偵錯教戰手冊,瞭解如何執行損失分析。
疑難排解
雖然受到隱私或資源保護措施的保護是正常現象,但其他損失可能會 可能會被視為非預期的實作項目設定錯誤或 瀏覽器本身可能會導致報表遺失。
您可以利用偵錯報表偵測並修正導入問題,或 向瀏覽器小組回報潛在錯誤。操作說明: 第 3 部分:偵錯教戰手冊。
進階設定檢查
Attribution Reporting API 的部分功能可讓您自訂 API 行為例如篩選規則、簡化規則以及優先順序規則。
使用這些功能時,請透過偵錯報表來檢查邏輯是否促成下列內容的預期行為: 不必等候歸因報表。如要瞭解如何執行這項作業,請參閱第 3 部分:偵錯教戰手冊。
使用可匯總報表進行本機測試
可匯總的偵錯報表與經過加密的可匯總歸因報表不同 請納入未加密酬載
使用可匯總的偵錯報表來驗證可匯總報表的內容。 並使用本機匯總工具產生摘要報表以供測試。
重新處理匯總服務報表
使用偵錯模式的另一項優點是,您可以再次處理報表。因此,如要多次處理報表,請務必啟用偵錯報表。 在某些情況下,建議您重新處理報表:
- 嘗試對匯總服務偵錯
- 嘗試不同的批次處理策略
- 嘗試不同的 Epsilon 值
資料復原
我們建議廣告技術啟用偵錯模式來接收偵錯報表,以便復原報表資料。這在發生匯總服務問題時 (例如服務無法使用或非回應服務),導致摘要報表生成失敗時,這個做法就能派上用場。