開始使用歸因報表

本指南提供 Attribution Reporting API 的總覽和設定說明,包括事件層級和摘要歸因報表。

首先,您將學習如何:

  • 區分 Attribution Reporting API 報表類型

  • 完成 API 導入和報表產生步驟

  • 尋找參考資料和疑難排解資訊

選擇報表類型

為有效評估廣告活動成效,並兼顧詳細程度和隱私權,Attribution Reporting API 提供兩種不同的報表類型:

  • 事件層級報表:提供精細資料,將特定廣告點擊或瀏覽 (來源) 與相應的轉換資料 (觸發條件) 連結。事件層級報表會限制轉換資料量,並在報表中加入雜訊。這類事件非常適合用於需要個別事件歸因的用途,例如評估廣告活動觸及。

  • 摘要報表:提供匯總的使用者資料,並可加入雜訊,提供更詳細的轉換資訊。這類報表是使用 Attribution Reporting API 和 Private Aggregation API,根據匯總報表建構而成,提供的資料模型比事件層級報表更豐富。摘要報表特別適合需要匯總洞察資料的應用情境,例如計算轉換價值,或分析各使用者區隔的廣告活動成效。

導入程序總覽

以下各節將概述產生每種報表的高階步驟。您也可以參閱 Attribution Reporting API 示範,逐步瞭解整個程序。

必要條件:網站必須具備 SSL/TLS 憑證 (HTTPS),才能註冊來源、觸發條件及接收報表。

產生事件層級報表

如要產生事件層級報表,請按照下列步驟操作:

  1. 登錄來源:將廣告點擊或瀏覽與歸因資訊建立關聯。如需詳細操作說明,請參閱「註冊歸因來源」和「歸因來源註冊」。請注意,點擊和觀看次數的註冊程序略有不同。

  2. 登錄觸發條件:記錄轉換事件,並連結至先前登錄的來源。如需操作說明,請參閱「註冊歸因觸發條件」。

  3. 設定報表端點:在伺服器上建立端點,接收事件層級報表。端點網址應採用下列格式:{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution。如需 POST 方法的範例,請參閱 adtech.js 中的範例程式碼。如要進一步瞭解 .well-known,請參閱 Wikipedia

如要深入瞭解事件層級報表,請參閱事件層級報表說明

產生摘要報表

  1. 登錄來源:與事件層級報表相同。詳情請參閱「登錄歸因來源」和「歸因來源登錄」。

  2. 登錄觸發事件:與事件層級報表相同。請參閱「註冊歸因觸發條件」。

  3. 設定報表端點:建立端點以接收匯總報表。網址應為:{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution。如需 POST 方法範例,請參閱 adtech.js,如需 .well-known 資訊,請參閱 Wikipedia

  4. 批次處理及傳送報表:批次處理匯總報表,並傳送至匯總服務進行處理。匯總服務接著會產生摘要報表。詳情請參閱批次處理策略

如要深入瞭解摘要報表,請參閱可匯總報表說明

除了實作步驟,下列主題也有助於您規劃摘要報表策略:

設定篩選器 (選用)

如要進一步控管收到的歸因資料,可以設定篩選器。

篩選功能可提供精細的資料分析,將特定資料子集分離出來供您分析,減少干擾。這也有助於追蹤特定廣告活動和轉換事件的成效,以便更精確地評估成效。

如要設定篩選條件,請參閱「使用篩選條件定義自訂規則」一文,以及「歸因觸發條件註冊」的觸發條件部分,瞭解可彙整報表的詳細資訊。

確認 API 已啟用

使用 API 前,請先使用下列程式碼檢查是否已啟用:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

這項檢查會指出目前環境是否允許使用 API。不過,使用者瀏覽器設定或其他因素仍可能導致 API 無法使用。基於隱私權考量,我們無法透過程式輔助方式,明確確認 API 可用性。

後續步驟

下列各節將進一步說明如何開始使用歸因報表。

導入作業

背景和概念

示範和工具

規劃