歡迎參考下列入門說明,包括設定和快速總覽。
選擇報表類型
您可以使用 Attribution Reporting API 產生兩種報表:事件層級和摘要報表。事件層級報表需要的設定較可匯總或摘要報表較少,因此適合從這類報表著手。摘要報表需要與匯總服務整合,但事件層級報表則沒有。
您可以同時設定事件層級報表和摘要報表的報表。相輔相成。
事件層級報表
事件層級報表,將特定廣告點擊或瀏覽 (在廣告端) 與轉換端的資料建立關聯。為了藉由限制跨網站整合使用者身分來維護使用者隱私,轉換端資料非常有限,而且資料十分雜亂。
摘要報表
摘要報表是 Attribution Reporting API 和 Private Aggregation API 的報表類型。摘要報表包含匯總的使用者資料,可包含詳細的轉換資料 (加上雜訊)。摘要報表由匯總報表組成。
導入作業
請先嘗試以下步驟。
請注意,您可以針對指定的事件來源,同時產生事件層級和可匯總報表。示範將逐步引導您完成整個程序。
產生事件層級報表
如要產生事件層級報表,請按照下列步驟操作:
登錄觸發條件。如需相關操作說明,請參閱「登錄歸因觸發條件」一文。
使用下列網址設定端點:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
如要查看post
方法,請參閱 adtech.js 中的範例程式碼。請前往此處進一步瞭解 .well-known。
如要進一步瞭解事件層級報表,請參閱本文。
產生摘要報表
如要產生摘要報表,請按照下列概略步驟操作:
登錄觸發條件。如需相關操作說明,請參閱「登錄歸因觸發條件」一文。
使用以下網址為可匯總報表設定端點:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
請參閱 adtech.js 中的範例程式碼以查看post
方法。請前往此處進一步瞭解 .well-known。
如要進一步瞭解摘要報表,請參閱這篇文章。
如要瞭解如何設定偵錯報表,請參閱「歸因報表偵錯系列」一文。
摘要報表的其他概念
除了瞭解此處的導入步驟,您還可以透過下列概念來規劃摘要報表策略:
選擇性步驟
- 設定篩選器 (選用):
- 請按照「使用篩選器定義自訂規則」一文的說明操作。
- 在說明的觸發條件部分中查看可匯總報表篩選器的特定詳細資料。
別忘了功能偵測
使用 API 前,請先使用 Permissions-Policy 偵測該 API 網頁上是否未受到封鎖。如要這麼做,請執行下列程式碼:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
如果這項特徵偵測檢查傳回 true,就能在執行檢查的內容 (頁面) 中使用這個 API。
請注意,單獨進行這項檢查並不保證該 API 可在該網頁上使用;使用者可能是根據瀏覽器設定停用 API,也可能是其他設定導致 API 無法使用。為了保護使用者隱私,您無法以程式輔助方式檢查這一點。
後續步驟
如果您已準備好開始導入作業,請參閱下列文件:
設定
背景
示範與工具
規劃
如果您仍處於規劃階段,請參閱下列文件: