部分 Privacy Sandbox 技術即將淘汰。

請參閱這篇文章，瞭解我們對 Privacy Sandbox 技術的計畫更新。

Privacy Sandbox 功能狀態提供個別 API 和平台功能的狀態資訊。

歸因報表：完整系統總覽

這份高階總覽適用於技術決策者，可瞭解歸因報表適用的連結服務。

廣告技術和廣告主可透過 Attribution Reporting API，評估廣告點擊或瀏覽促成轉換 (例如購買) 的時間。這個 API 依據您的業務需求，結合了用戶端和伺服器端整合功能。

繼續操作前，請務必詳閱歸因報表總覽。這有助於瞭解 API 的用途，以及不同輸出報表 (事件層級報表和摘要報表) 的流程。如果遇到不熟悉的字詞，請參閱 Privacy Sandbox 詞彙表。

這份文件的目標讀者是誰？

如果您有下列情形，請閱讀這份文件：

您是廣告技術或廣告主的技術決策者。您可能在營運、DevOps、資料科學、IT、行銷或其他職位工作，負責制定技術實作決策。您想瞭解 API 如何運作，以保護隱私權的方式進行評估。
您是技術實務人員 (例如開發人員、系統操作員、系統架構師或資料科學家)，負責使用這個 API 和匯總服務環境設定實驗。

本文將從高層次的角度，全面說明 Attribution Reporting API 服務的運作方式。如果您是技術人員，可以在本機測試這項 API。

總覽

Attribution Reporting API 包含多項服務，需要進行特定設定、用戶端設定和伺服器部署作業。如要判斷所需項目，請先：

決定設計方式。定義要收集的資訊、找出您預期任何指定廣告活動帶來的轉換，並決定要收集的報表類型。最終輸出結果為一或兩種報表：事件層級報表和摘要報表。

通常有兩個 (有時是三個) 元件會一起運作，支援報表功能：

網站與瀏覽器之間的通訊。在以 Cookie 為基礎的系統中，轉換和廣告參與的相關資訊會附加至 ID，方便您或分析服務稍後加入這些事件。這個 API 會根據您的指示，在瀏覽器將轉換資料傳送給您進行分析前，先將轉換與廣告點擊/瀏覽建立關聯。因此，廣告顯示程式碼和轉換追蹤必須：
- 告訴瀏覽器哪些轉換應歸因於哪些廣告點擊或曝光。
- 發出信號，指出要納入最終報表的其他資料。
資料收集。您需要收集器端點，才能接收使用者瀏覽器產生的報表。瀏覽器可能會輸出兩種報表：事件層級報表和可匯總報表 (經過加密，用於產生摘要報表)。

如果您收集了可匯總報表，則需要第三個元件：

產生摘要報表：批次處理可匯總報表，並使用匯總服務處理報表，產生摘要報表。

設計決策

歸因報表的重要原則是早期設計決策。您可以決定要收集哪些類別的資料，以及處理這些資料的頻率。輸出報表可提供廣告活動或業務的洞察資料。

輸出報表可以是：

事件層級報表會將特定廣告點擊或瀏覽 (在廣告端) 與轉換端的資料建立關聯。為保護使用者隱私，系統會限制跨網站彙整使用者身分，因此轉換端資料非常有限，且資料會加入雜訊 (也就是說，在少數情況下，系統會傳送隨機資料，而非實際報表)。
摘要報表不會與廣告端的特定事件相關聯。這些報表提供更詳盡的轉換資料，並可彈性地將點擊和瀏覽資料與轉換資料合併。

您選取的報表會決定需要收集哪些資料。

您也可以將最終輸出內容視為決策工具的輸入內容。舉例來說，如果您產生摘要報表，判斷有多少轉換帶來總支出價值，團隊就能據此決定下一個廣告活動應以什麼為目標，以產生更高的總支出。

決定要評估的內容後，即可設定 Attribution Reporting API 的用戶端。

網站與瀏覽器之間的通訊

歸因事件流程

假設發布商網站會顯示廣告。每位廣告主或廣告技術供應商都想瞭解廣告互動情形，並將轉換歸因於正確的廣告。系統會產生下列報表 (事件層級和可匯總)：

在發布商網站上，廣告元素 (<a> 或 <img> 代碼) 會設定特殊屬性 attributionsrc。其值為網址，例如 https://adtech.example/register-source/ad_id=...。

以下是連結範例，點選後會註冊來源：
```
<a href="https://shoes.example/landing"
  attributionsrc="http://adtech.example/register-source?..."
  target="_blank">
Click me</a>
```
以下是圖片範例，檢視時會導致來源註冊：
```
<img href="https://advertiser.example/landing"
  attributionsrc="https://adtech.example/register-source?..."/>
```
或者，您也可以使用 JavaScript 呼叫，而非 HTML 元素。

以下是使用 window.open() 的 JavaScript 範例。請注意，網址會經過網址編碼，避免特殊字元造成問題。
```
const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
  "_blank",
  `attributionsrc=${encodedUrl}`);
```
使用者點按或瀏覽廣告時，瀏覽器會向 attributionsrc (通常是廣告主或廣告技術供應商端點) 送出 GET 要求。
收到這項要求後，廣告主或廣告技術供應商會決定指示瀏覽器註冊來源事件，以便將轉換歸給這則廣告。為此，廣告主或廣告技術供應商會在回應中加入特殊 HTTP 標頭。這個標頭會附加自訂資料，提供來源事件 (廣告點擊或瀏覽) 的相關資訊。如果這個廣告最終促成轉換，這項自訂資料就會顯示在歸因報表中。
之後，使用者造訪廣告主的網站。
在廣告主網站的每個相關網頁 (例如購買確認頁面或產品頁面)，轉換像素 (<img> 元素) 或 JavaScript 呼叫會向 https://adtech.example/conversion?param1=...&param2=... 發出要求。
這個網址的服務 (通常是廣告主或廣告技術供應商) 會收到要求。系統決定將此歸類為轉換，因此需要指示瀏覽器記錄轉換，也就是觸發歸因。為此，廣告主或廣告技術供應商會在像素要求的回應中加入特殊 HTTP 標頭，其中包含轉換的自訂資料。
使用者本機裝置上的瀏覽器會收到這項回應，並將轉換資料與原始來源事件 (廣告點擊或瀏覽) 進行比對。
瀏覽器會安排將報告傳送至 attributionsrc。這份報表包含：
1. 廣告技術供應商或廣告主在步驟 3 中附加至來源事件的自訂歸因設定資料。
2. 步驟 6 的自訂轉換資料集。
這張圖表顯示 Attribution Reporting 觸發的元素，這些元素會產生事件層級和可匯總報表。
產生報表後，瀏覽器會將報表傳送到 attributionsrc 中定義的端點，傳送作業可能會有所延遲，也可能會一併傳送一些雜訊。可匯總報表會經過加密，事件層級報表則不會。

歸因觸發條件 (廣告主網站)

歸因觸發條件 是告知瀏覽器擷取轉換的事件。

建議您擷取對廣告主而言最重要的轉換，例如購買。摘要報表可擷取多種轉換類型和中繼資料。

確保這些事件的匯總結果詳細且準確。

將來源與觸發條件配對

瀏覽器收到歸因觸發事件回應時，會存取本機儲存空間，找出與歸因觸發事件來源和該網頁網址的 eTLD+1 相符的來源。

舉例來說，當瀏覽器在 shoes.example/shoes123 上收到來自 adtech.example 的歸因觸發條件時，瀏覽器會在本機儲存空間中尋找同時符合 adtech.example 和 shoes.example 的來源。

您可以設定篩選器 (或自訂規則)，判斷觸發條件何時與特定來源相符。舉例來說，您可以設定篩選條件，只計算特定產品類別的轉換，並忽略所有其他類別。篩選器和優先順序模型可提供更進階的歸因報表。

如果本機儲存空間中有多個歸因來源，瀏覽器會選擇最近儲存的來源。在某些情況下，如果歸因來源已指派優先順序，瀏覽器會選取優先順序最高的來源。

資料收集

瀏覽器會將與相應來源相符的歸因觸發事件，一併以報表形式傳送至廣告技術自有伺服器上的報表端點 (有時稱為收集端點或收集服務)。這些報表可以是事件層級報表或可匯總報表。

可匯總報表可用於產生摘要報表。可匯總報表是從廣告 (在發布商網站上) 收集的資料，以及轉換資料 (來自廣告主網站) 的組合，由使用者裝置上的瀏覽器產生並加密，再由廣告技術收集。

事件層級報表會延遲 2 到 30 天。匯總報表會在 1 小時內隨機延遲傳送，且事件必須符合貢獻預算。這些選擇可保護隱私權，並防止濫用任何個別使用者的動作。

如果只需要事件層級報表，這是您需要的最後一項基礎架構。不過，如要產生摘要報表，您需要使用其他服務處理可匯總的報表。

產生摘要報表

如要產生摘要報表，請使用匯總服務 (由廣告技術營運) 處理可匯總的報表。匯總服務會加入雜訊來保護使用者隱私，並傳回最終摘要報表。

系統會收集可匯總報表、批次處理，然後傳送至廣告技術環境。 — 這張圖代表資料從收集端點、批次處理報表，到廣告技術擁有的匯總服務處理的非同步流程。

匯總服務會處理收集到的可匯總報表批次。協調器只會將解密金鑰提供給經過認證的匯總服務版本。接著，匯總服務會解密資料、匯總資料並加入雜訊，然後以摘要報表的形式傳回結果。

批次可匯總報表

可匯總報表必須先批次處理，才能進行後續作業。批次包含策略性分組的可匯總報表。您的策略很可能反映特定時間範圍 (例如每日或每週)。這個程序可以在做為報表端點的同一部伺服器上進行。

批次應包含多份報告，確保訊號雜訊比偏高。

時間範圍越大，結果的雜訊就越少。 — 比較等待 1 天和 1 週。1 小時後，您會得到較小的摘要值，結果可能也會有更多雜訊。這樣一天的摘要值會比較大，因此雜訊較少。

您可以隨時變更批次期間，確保能掌握預期交易量較高的特定活動，例如年度特賣。批次處理週期可以變更，無須變更歸因來源或觸發條件。

匯總服務

匯總服務負責處理可匯總報表，以產生摘要報表。可匯總報表會經過加密，且只能由在受信任執行環境 (TEE) 中執行的匯總服務讀取。

匯總服務會向協調器要求解密金鑰，以便解密及匯總資料。解密及匯總後，系統會對結果加入雜訊以保護隱私權，並以摘要報表的形式傳回。

實務工作者可以產生可匯總的明文報表，在本機測試匯總服務。或者，您也可以在 AWS 上使用 Nitro Enclaves 測試加密報表。

後續步驟

我們希望與您對話，確保建構的 API 適合所有人。

討論 API

與其他 Privacy Sandbox API 相同，這個 API 也會公開討論並提供相關文件。

試用 API

您可以實驗並參與有關 Attribution Reporting API 的對話。