本頁面由 Cloud Translation API 翻譯而成。

開始使用歸因報表

歡迎參考下列入門說明，包括設定和快速總覽。

選擇報表類型

您可以使用 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 無法使用。為了保護使用者隱私，您無法以程式輔助方式檢查這一點。