Attribution Reporting 偵錯報表簡介

第 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 值

資料復原

我們建議廣告技術啟用偵錯模式來接收偵錯報表,以便復原報表資料。這在發生匯總服務問題時 (例如服務無法使用或非回應服務),導致摘要報表生成失敗時,這個做法就能派上用場。

即將播放

第 2 部分:設定偵錯報表