評估廣告點擊或瀏覽促成的轉換,例如在廣告客戶網站上購物。
適用對象
這裡會說明歸因報表的基本概念和一些基礎概念,但不會提供太多技術細節。
- 如果您從事廣告或廣告技術工作,將可瞭解這個 API 如何提供由第三方 Cookie 啟用的功能。請查看 API 用途,進一步瞭解產生報表的方式。
- 如果您是開發人員或軟體工程師,請前往完整的系統總覽或實驗並參與 API。
廣告主和發布商如果要使用廣告技術平台來評估轉換,就不需要直接使用 API。如果您的廣告技術計畫要整合這個 API,您可能會想瞭解歸因報表的運作方式。
什麼是 Attribution Reporting API?
目前,廣告轉換評估通常會仰賴第三方 Cookie。瀏覽器會限制第三方 Cookie 的存取權,因為這些 Cookie 可用於跨網站追蹤使用者,並侵害使用者的隱私權。
Attribution Reporting API 可在不使用第三方 Cookie 的情況下,以保護隱私權的方式評估成效。
這個 API 可讓廣告主和廣告技術供應商在下列情況下評估轉換:
- 廣告點擊和觀看次數。
- 第三方 iframe 中的廣告,例如使用第三方廣告技術供應商的發布商網站上的廣告。
- 第一方內容中的廣告,例如社群網路或搜尋引擎結果網頁上的廣告,或是發布商放送自家廣告。
如果您不熟悉這些術語或概念,請參閱 Privacy Sandbox 詞彙解釋。
試用 API
- 在本機瀏覽器中進行測試。設定標記,指示 Chrome 瀏覽器啟用特定實驗功能。
如想試用 API,請參閱「歸因報表:實驗及參與」一文。
API 變更
- 追蹤 API 變更。
- 瞭解我們為何在 2023 上半年推出 Attribution Reporting API。
可用性
提案 | 狀態 |
---|---|
轉換歷程:應用程式到網頁 網頁說明和 Android 說明 郵寄清單公告 |
適用於 Chrome 和 Android 的來源試用 |
轉換歷程:跨裝置 說明 |
這項提案已封存。目前沒有實施這項功能的計畫。 |
使用報表驗證功能,避免產生無效的可匯總報表 說明 |
這項提案已封存。我們已改為為此用途實作 trigger_context_id 。 |
Attribution Reporting API Permissions-Policy 的預設許可清單將維持不變 * Mailing list announcement |
2023 年第 1 季推出的 Chrome 版本 |
可設定的事件層級報表 epsilon GitHub 問題 |
2023 年第 4 季在 Chrome 推出 |
可匯總報表酬載的填充值 更新說明 |
2023 年第 4 季在 Chrome 推出 |
彈性事件層級 彈性事件層級設定說明 |
2023 年第 4 季推出的 Chrome 版本
可自訂歸因報表數量和報表回溯期數/長度。 2024 年第 1 季推出的 Chrome 版本 可自訂觸發事件資料位元數。 |
支援不依賴第三方 Cookie 的歸因報表現詳細偵錯報表 說明 |
2024 年第 3 季在 Chrome 推出 |
支援 Attribution Reporting API 和 Google Cloud 的匯總服務 Attribution Reporting API 說明 匯總服務說明 |
2023 下半年推出的 Chrome 版本 |
彈性貢獻內容篩選功能 說明 |
2024 年第 3 季在 Chrome 推出 |
歸因前篩選:歸因範圍 說明 |
2024 年第 4 季在 Chrome 推出 |
用途和功能
Attribution Reporting API 可提供不同類型的洞察資料,並提供兩種報表,可傳送給廣告主或第三方廣告技術供應商。這兩種報表相輔相成,並可同時使用。
- 事件層級報表:將特定廣告點擊或瀏覽 (廣告端) 與轉換端的資料建立關聯。轉換端資料非常有限,且資料會受到雜訊干擾 (也就是說,在極少數情況下,系統會傳送隨機資料,而非實際報表)。這項功能可防止跨網站的使用者身分彙整,進而保護使用者隱私。為提供額外的隱私權保護,系統會延遲一段時間才傳送報告。
- 摘要報表與廣告端的特定事件無關,相較於事件層級報表,這類報表提供更豐富、更精確的轉換資料。結合多種隱私權技術,有助於降低跨網站身分比對的風險。
事件層級報表
事件層級報表會將廣告點擊或瀏覽與粗略轉換資料建立關聯。
![事件層級報表](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=0&hl=zh-tw)
news.example
上的點擊 ID 200400600 (已連結至 news.example
上的使用者 ID Bob_Doe) 促成 shop.example
上的購物交易。事件層級報表適合用於:
- 最佳化。回答「如何提高投資報酬率?」等問題。特別是,這些報表可用於改善廣告刊登位置,因為報表中會提供廣告端專屬 ID。事件層級報表可為機器學習模型提供訓練資料。
- 粗略報表:只需要少量轉換資訊。目前的限制是,點擊的轉換資料上限為 3 位元 (也就是說,轉換可指派八個類別的其中一個類別),瀏覽的轉換資料上限為 1 位元。事件層級報表不支援將精細的轉換端資料 (例如特定價格或轉換時間) 進行編碼。
- 詐欺偵測。部分報表中的資料可用於偵測及分析廣告詐欺行為,因為這些資料可讓您瞭解可用於識別垃圾內容或無效活動的模式。
摘要報表
摘要報表 (舊稱匯總報表) 提供更詳細的轉換資料,並可更靈活地彙整點擊或瀏覽資料和轉換資料。
進一步瞭解摘要報表。
![摘要報表中的洞察資料範例。](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=0&hl=zh-tw)
news.example
的廣告活動 ID 1234567 在 shoes.example
上帶來 518 次轉換,總支出金額為 $38174 美元。一半的轉換來自美國紐約市的使用者。摘要報表最適合用於報表用途。這些報表有助於解答「我的投資報酬率是多少?」等問題。
我們目前積極研究如何使用摘要報表進行最佳化,例如為購物價值進行最佳化 (事件層級報表不支援此功能,因為轉換資料太粗略)。
其他功能
這個 API 的其他功能包括:
- 應用程式至網頁歸因:在應用程式中看到或點選廣告,然後在網頁上完成轉換。
瀏覽器支援
雖然這兩個 API 不同,但 Chrome 和 WebKit 會在開放環境中合作,簡化開發人員體驗,例如在屬性名稱和報表的 JSON 結構上保持一致。
Attribution Reporting API 的功能組合與 Safari 和 WebKit 提出的 Private Click Measurement API 不同。最值得一提的是,Attribution Reporting API 可讓您:
- 支援瀏覽後評估。
- 可提供事件層級報表。
- 摘要報表包含點擊/瀏覽和轉換的豐富資訊。
- 廣告技術平台等第三方可以代表發布商和廣告主接收報表。
瀏覽器設定
- 使用者可以透過
chrome://settings/adPrivacy
中的使用者設定停用 API。 - 在無痕模式中,API 不會處於啟用狀態。
網站如何控管存取權?
如果 API 可在特定瀏覽器中使用,則預設可在任何特定網站中使用,包括頂層文件和指令碼,以及同源 iframe。
任意第三方 (例如未透過具有頂層存取權的指令碼新增至網頁的跨來源廣告 iframe) 無法在未經發布商或廣告主同意的情況下使用 API:在這些 iframe 中,必須透過權限政策明確啟用歸因報表 API。
<iframe src="..." allow="attribution-reporting"></iframe>
擁有頂層存取權的第三方在網頁中加入跨來源 iframe 時,也可以透過權限政策啟用 Attribution Reporting API。
網站可以傳送 HTTP 回應標頭,為所有相關方停用 Attribution Reporting API,包括具有頂層存取權的腳本:
Permissions-Policy: attribution-reporting=()
Attribution Reporting API 的運作方式
Attribution Reporting API 有助於評估兩個已建立連結的事件:發布商網站上的事件,例如有使用者瀏覽或點按廣告,然後在廣告主網站上完成轉換。
事件層級報表
![事件層級報表](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=0&hl=zh-tw)
瀏覽器比對點擊或瀏覽,發現與廣告技術定義的轉換資料相符。
產生報表後,瀏覽器會將報表傳送到預先定義的端點,傳送作業可能會有所延遲,也可能會一併傳送一些雜訊。
摘要報表
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=0&hl=zh-tw)
摘要報表的產生過程如下:
- 使用者點按或瀏覽了特別設定的廣告。使用者本機裝置上的瀏覽器記錄此事件,並保存預先指定的歸因設定資料。
- 稍後,使用者完成轉換時,瀏覽器會將這個詳細點擊或瀏覽事件 (稱為歸因來源事件) 與轉換詳細資料 (稱為歸因觸發資料) 進行比對。所擷取詳細資料的維度是由廣告技術公司預先定義,瀏覽器會採用廣告技術定義的特定邏輯。瀏覽器會以可匯總報表的形式匯出這項資料。
- 瀏覽器會將可匯總報表加密處理,再傳送到廣告技術伺服器。接著,廣告技術伺服器會將該報表傳送到匯總服務,以便產生摘要報表。
- 廣告技術隨後就能存取摘要報表。請注意,摘要報表的傳送作業不會像事件層級報表一樣有所延遲。
進一步瞭解摘要報表。
隱私權
與第三方 Cookie 不同,Attribution Reporting API 可讓廣告公司取得轉換洞察資料,不必追蹤個別使用者在各網站上的活動。
舉例來說,假設有一位名叫 Bob 的使用者,小明在 news.example
上閱讀新聞時看到廣告。一週後,阿斌在 shoes.example
購買鞋子。
目前,這類轉換會透過用於跨網站 ID的第三方 Cookie 進行追蹤。透過第三方 Cookie,廣告技術公司可以取得 Bob 在 news.example
和 shoes.example
上的活動詳細資料。廣告技術可以將這些資訊合併,建立 Bob 的詳細個人資料,包括 Bob 的位置、瀏覽習慣和 news.example
上偏好的閱讀內容。這個設定檔也可能包含 shoes.example
上的購買交易、活動和信用卡資訊。這項跨網站連結可用於評估廣告轉換。但這會侵害使用者隱私:Bob 的活動會在各個網站上以極為詳細的方式追蹤。
![並排顯示現今的網路 (已彙整身分) 和未來的網路 (已劃分身分)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=0&hl=zh-tw)
系統會在各個網站之間彙整少量資訊,雖然足以評估轉換,但無法詳細追蹤 Bob 在各個網站上的活動。Bob 在 news.example
和 shoes.example
上的活動仍是分開的。
各報表類型的防護措施
事件層級報表會將廣告端 ID 與少量轉換端資料建立關聯。雖然這類事件確實會提供跨網站的轉換資訊,但轉換方資訊過於粗略,無法在各網站之間加入使用者身分。
摘要報表可提供詳細深入分析,但僅限於匯總層級;由於這些可匯總報表的內容會在傳送至廣告技術時加密,因此廣告技術無法使用匯總服務,就無法從報表取得任何資訊。匯總服務只提供雜訊匯總的存取權。
事件層級和匯總報表都會受到額外隱私權保護,例如費率限制。
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=0&hl=zh-tw)
詳細說明:事件層級報表和隱私權
事件層級報表會遵循下列隱私權機制,在不追蹤跨網站使用者的情況下,提供轉換洞察資料:
- 不會使用跨網站 ID,且不會將詳細的跨網站瀏覽活動離開裝置。
- 事件層級報表會將廣告端 (
news.example
) 的 64 位元資訊,與轉換端 (shop.example
) 的 1 位元或 3 位元資訊建立關聯。64 位元資訊足以對應至個別使用者 ID,但這些 64 位元資訊只能連結非常少量的跨網站資訊 (1 位元或 3 位元),無法儲存 ID。- 廣告端 64 位元並非新資訊。使用者 ID 現已可在廣告端使用。
news.example
或adtech.example
已知某位使用者在news.example
上的活動。
- 廣告端 64 位元並非新資訊。使用者 ID 現已可在廣告端使用。
- 我們也採用其他防護措施,防止濫用行為和跨網站追蹤:
- 報表會延遲傳送。
- 轉換資料會產生雜訊:在某些情況下,系統會產生假報表。
- 每個點擊或瀏覽的歸因轉換報表數量有限。
詳細說明:摘要報表和隱私權
摘要報表會將點擊或瀏覽事件與詳細轉換資料建立關聯。這些廣告活動會採用下列隱私權機制,在不追蹤使用者跨網站活動的情況下,提供轉換洞察資料:
- 不會使用跨網站 ID。
- 每個歸因來源都可為最終的摘要報表貢獻多次。任何使用者都可能針對特定點擊 (或觀看) 和轉換觸發多個歸因。
- 資料會匯總至多個事件 (多位使用者) 的層級,因此無法精確觀察個別事件。查看匯總資料時,隨著詳細程度增加,資料的相對雜訊也會增加。匯總大量事件和使用者的資料切片會更準確,因此更實用。
- 將詳細點擊或瀏覽事件與詳細轉換資料建立關聯的原始報表會加密,廣告技術公司無法讀取。只有匯總服務可以讀取這項資料。
- 我們會採用其他防護措施,防止濫用行為和跨網站追蹤:
- 系統會隨機延遲傳送報表。
- 針對不同資料區塊的查詢有頻率限制。
互動及分享意見回饋
- 如有 API 相關問題,請在 API 存放區建立問題。
- 請訂閱 Attribution Reporting 郵寄清單,掌握 API 最新消息和公告。
- 如有技術問題,請回報 Chromium 錯誤。
- 如有實作、整合和一般最佳做法的問題:請在 Privacy Sandbox 開發人員支援存放區建立問題。