本指南提供使用 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，請參閱 維基百科。
如要進一步瞭解事件層級報表，請參閱「事件層級報表說明」。
產生摘要報表
註冊觸發事件：與事件層級報表相同。請參閱「註冊歸因觸發條件」。
設定報表端點：建立端點來接收匯總報表。網址應為：
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution。如需POST方法範例，請參閱adtech.js；如需.well-known資訊，請參閱 維基百科。批次處理及傳送報表：將匯總報表批次處理並傳送至匯總服務進行處理。匯總服務隨後會產生摘要報表。詳情請參閱「批次處理策略」。
如要進一步瞭解摘要報表，請參閱可匯總報表說明。
除了實作步驟之外，下列主題也會協助您規劃摘要報表策略：
設定篩選器 (選用)
如要進一步控管所收到的歸因資料，您可以設定篩選條件。
篩選器可提供精細的資料分析，將特定資料子集隔離出來進行分析，以減少雜訊。這項功能也有助於追蹤特定廣告活動和轉換事件的成效，以便更精確地評估成效。
如要設定篩選條件，請參閱「使用篩選器定義自訂規則」和「歸因觸發事件註冊」中的觸發事件部分，瞭解可匯總報表的詳細資訊。
確認已啟用 API
使用 API 前，請使用下列程式碼檢查 API 是否已啟用：
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
這項檢查可指出是否允許在目前的情況下使用 API。不過，使用者的瀏覽器設定或其他因素，仍可能會導致無法使用 API。基於隱私權考量，我們無法透過程式輔助方式來明確確認 API 可用性。
後續步驟
下列各節將進一步說明如何開始使用歸因報表。