本指南提供 Attribution Reporting API 的總覽和設定說明,包括事件層級和摘要歸因報表。
首先,您將學習如何:
區分 Attribution Reporting API 報表類型
完成 API 導入和報表產生步驟
尋找參考資料和疑難排解資訊
選擇報表類型
為有效評估廣告活動成效,並兼顧詳細程度和隱私權,Attribution Reporting API 提供兩種不同的報表類型:
事件層級報表:提供精細資料,將特定廣告點擊或瀏覽 (來源) 與相應的轉換資料 (觸發條件) 連結。事件層級報表會限制轉換資料量,並在報表中加入雜訊。這類事件非常適合用於需要個別事件歸因的用途,例如評估廣告活動觸及。
摘要報表:提供匯總的使用者資料,並可加入雜訊,提供更詳細的轉換資訊。這類報表是使用 Attribution Reporting API 和 Private Aggregation API,根據匯總報表建構而成,提供的資料模型比事件層級報表更豐富。摘要報表特別適合需要匯總洞察資料的應用情境,例如計算轉換價值,或分析各使用者區隔的廣告活動成效。
導入程序總覽
以下各節將概述產生每種報表的高階步驟。您也可以參閱 Attribution Reporting API 示範,逐步瞭解整個程序。
必要條件:網站必須具備 SSL/TLS 憑證 (HTTPS),才能註冊來源、觸發條件及接收報表。
產生事件層級報表
如要產生事件層級報表,請按照下列步驟操作:
登錄來源:將廣告點擊或瀏覽與歸因資訊建立關聯。如需詳細操作說明,請參閱「註冊歸因來源」和「歸因來源註冊」。請注意,點擊和觀看次數的註冊程序略有不同。
登錄觸發條件:記錄轉換事件,並連結至先前登錄的來源。如需操作說明,請參閱「註冊歸因觸發條件」。
設定報表端點:在伺服器上建立端點,接收事件層級報表。端點網址應採用下列格式:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution。如需POST方法的範例,請參閱adtech.js中的範例程式碼。如要進一步瞭解.well-known,請參閱 Wikipedia。
如要深入瞭解事件層級報表,請參閱事件層級報表說明。
產生摘要報表
登錄觸發事件:與事件層級報表相同。請參閱「註冊歸因觸發條件」。
設定報表端點:建立端點以接收匯總報表。網址應為:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution。如需POST方法範例,請參閱adtech.js,如需.well-known資訊,請參閱 Wikipedia。
如要深入瞭解摘要報表,請參閱可匯總報表說明。
除了實作步驟,下列主題也有助於您規劃摘要報表策略:
設定篩選器 (選用)
如要進一步控管收到的歸因資料,可以設定篩選器。
篩選功能可提供精細的資料分析,將特定資料子集分離出來供您分析,減少干擾。這也有助於追蹤特定廣告活動和轉換事件的成效,以便更精確地評估成效。
如要設定篩選條件,請參閱「使用篩選條件定義自訂規則」一文,以及「歸因觸發條件註冊」的觸發條件部分,瞭解可彙整報表的詳細資訊。
確認 API 已啟用
使用 API 前,請先使用下列程式碼檢查是否已啟用:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
這項檢查會指出目前環境是否允許使用 API。不過,使用者瀏覽器設定或其他因素仍可能導致 API 無法使用。基於隱私權考量,我們無法透過程式輔助方式,明確確認 API 可用性。
後續步驟
下列各節將進一步說明如何開始使用歸因報表。