開始使用歸因報表

以下是該從何處著手,包括設定和簡介。

選擇報表類型

Attribution Reporting API 可讓您產生兩種報表:事件層級報表和摘要報表。相較於可匯總報表或摘要報表,事件層級報表需要的設定較少,因此適合從這類報表著手。摘要報表必須與匯總服務整合,事件層級報表則不需要。

您可以同時設定事件層級和摘要報表。兩者相輔相成:

事件層級報表

事件層級報表,將特定廣告點擊或瀏覽 (在廣告端) 與轉換端的資料建立關聯。為了藉由限制跨網站整合使用者身分來維護使用者隱私,轉換端資料非常有限,而且資料十分雜亂。

摘要報表

摘要報表是 Attribution Reporting API 和 Private Aggregation API 的報表類型。摘要報表包含匯總的使用者資料,可包含詳細的轉換資料 (加上雜訊)。摘要報表由匯總報表組成。

導入作業

首先,請試著按照以下步驟操作。

請注意,如果是特定事件來源,則可以同時產生事件層級報表和可匯總報表。示範會逐步引導您完成這個程序。

產生事件層級報表

產生事件層級報表的基本步驟如下:

  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. 批次處理並傳送報表,由匯總服務進一步處理,其中會產生摘要報表。請參閱批次可匯總報表

詳情請參閱可匯總報表說明

如要瞭解如何設定偵錯報表,請參閱「歸因報表偵錯系列」一文。

摘要報表其他概念

除了瞭解這裡的導入步驟外,您還可以參考下列概念來規劃摘要報表策略:

選擇性步驟

  1. 設定篩選器 (選用)
    1. 請按照使用篩選器定義自訂規則中的指示操作。
    2. 前往說明的「觸發條件」部分,查看可匯總報表的篩選器相關詳細資料。

別忘了功能偵測

使用 API 前,請先透過權限政策檢查 API 是否未遭到封鎖。如要這樣做,請執行下列指令:

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

如果這項功能偵測檢查傳回 true,系統就會在執行檢查的環境中 (網頁) 允許該 API。

請注意,僅進行這項檢查並不保證該 API 可在該網頁上使用;使用者可能透過瀏覽器設定停用 API,或可能有其他設定導致 API 無法使用。為了保護使用者隱私,我們無法以程式輔助方式檢查此設定。

後續步驟

如果您已準備好開始實作,請參閱下列文件:

設定

背景

示範和工具

規劃

如果您仍在規劃階段,請參閱下列文件: