以下是該從何處著手,包括設定和簡介。
選擇報表類型
Attribution Reporting API 可讓您產生兩種報表:事件層級報表和摘要報表。相較於可匯總報表或摘要報表,事件層級報表需要的設定較少,因此適合從這類報表著手。摘要報表需要與匯總服務整合;事件層級報表除外
您可以同時設定事件層級和摘要報表。兩者相輔相成:
事件層級報表
事件層級報表,將特定廣告點擊或瀏覽 (在廣告端) 與轉換端的資料建立關聯。為了藉由限制跨網站整合使用者身分來維護使用者隱私,轉換端資料非常有限,而且資料十分雜亂。
摘要報表
Attribution Reporting API 和 Private Aggregation API 報表類型。摘要報表包含匯總的使用者資料,並可納入加入雜訊的詳細轉換資料。摘要報表是由匯總報表組成。相較於事件層級報表,這類報表提供更大的彈性,並提供更豐富的資料模型,特別適用於轉換價值等某些用途。
導入作業
首先,請試著按照以下步驟操作。
請注意,如果是指定的事件來源,就可以同時產生 事件層級和可匯總報表 示範會逐步引導您完成這個程序。
產生事件層級報表
產生事件層級報表的基本步驟如下:
登錄觸發條件。相關操作說明請參閱「登錄歸因觸發條件」一文。
使用以下網址設定端點:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
。
請參閱 adtech.js 中的程式碼範例,瞭解POST
方法;如要進一步瞭解.well-known
,請參閱 Wikipedia。
詳情請參閱事件層級報表說明。
產生摘要報表
如要產生摘要報表,請按照下列概略步驟操作:
登錄觸發條件。相關操作說明請參閱「登錄歸因觸發條件」一文。
為含有以下網址的可匯總報表設定端點:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
。
請參閱 adtech.js 中的程式碼範例,瞭解POST
方法;如要進一步瞭解.well-known
,請參閱 Wikipedia。
詳情請參閱可匯總報表說明。
如要瞭解如何設定偵錯報表,請參閱「歸因報表偵錯系列」一文。
摘要報表其他概念
除了瞭解這裡的導入步驟外,您還可以參考下列概念來規劃摘要報表策略:
選擇性步驟
- 設定篩選器 (選用):
- 請遵循指示: 使用篩選器定義自訂規則。
- 前往以下頁面查看可匯總報表的篩選器相關詳細資料: 請前往「觸發條件」部分 說明。
別忘了功能偵測
使用 API 前,請先透過權限政策檢查 API 是否未遭到封鎖。 如要這樣做,請執行下列指令:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
如果這項功能偵測檢查傳回 true,系統就會在執行檢查的環境中 (網頁) 允許該 API。
請注意,這項檢查並不代表 API 可在該網頁上使用;使用者可能透過瀏覽器設定停用 API,或可能有其他設定導致 API 無法使用。為了保護使用者隱私,我們無法以程式輔助方式檢查此設定。
後續步驟
如果您已準備好開始實作,請參閱下列文件:
設定
背景
示範和工具
規劃
如果您仍在規劃階段,請參閱下列文件: