評估廣告點擊或觀看促成的轉換,例如在廣告主網站上完成購物。
適用對象
本文將介紹歸因報表的基本概念和一些基礎概念,但不會深入探討技術細節。
- 如果您從事廣告或廣告技術工作,將瞭解這項 API 如何提供第三方 Cookie 支援的功能。請參閱 API 用途,進一步瞭解報表產生方式。
- 如果您是開發人員或軟體工程師,請前往完整系統總覽或實驗並參與 API。
如果廣告主和發布商使用廣告技術平台評估轉換,就不需要直接使用 API。如果您的廣告技術打算整合這項 API,您可能會想瞭解 Attribution Reporting 的運作方式。
什麼是 Attribution Reporting API?
目前廣告轉換評估作業通常會使用第三方 Cookie。瀏覽器限制第三方 Cookie 的存取權,是因為這類 Cookie 可用於跨網站追蹤使用者,侵犯使用者隱私權。
您可透過 Attribution Reporting API 評估轉換,不必使用第三方 Cookie,同時保護隱私權。
廣告主和廣告技術供應商可透過這項 API,在下列情況中評估轉換:
- 廣告點擊和瀏覽次數。
- 第三方 iframe 中的廣告,例如使用第三方廣告技術供應商的發布商網站上的廣告。
- 第一方環境中的廣告,例如社群網路或搜尋引擎結果網頁上的廣告,或是發布商放送的自家廣告。
如果您不熟悉部分術語或概念,請參閱 Privacy Sandbox 詞彙表。
試用 API
- 在瀏覽器中進行本機測試。設定旗標,告知 Chrome 瀏覽器啟用特定實驗功能。
如要試用 API,請前往「Attribution Reporting:實驗與參與」頁面。
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 提供兩種報表,可傳送給廣告主或第三方廣告技術供應商,讓他們取得不同類型的洞察資料。這兩種報表可同時使用,相輔相成。
- 事件層級報表:將特定廣告點擊或瀏覽 (在廣告端) 與轉換端資料建立關聯。轉換端資料非常有限,而且資料會經過加噪處理 (也就是說,在少數情況下,系統會傳送隨機資料,而非實際報表)。這項功能可防止網站合併使用者身分,藉此保護使用者隱私。為進一步保護隱私權,系統會延遲傳送報告。
- 摘要報表不會與廣告端的特定事件相關聯。相較於事件層級報表,這類報表提供更豐富、更精確的轉換資料。多種隱私權技術結合使用,有助於降低跨網站身分連結的風險。
事件層級報表
事件層級報表會將廣告點擊或瀏覽與粗略轉換資料建立關聯。
news.example 上 (附加至 news.example 上的使用者 ID Bob_Doe) 的點擊 ID 200400600,已在 shop.example 上促成購買。事件層級報表適用於:
- 最佳化。回答「如何提高投資報酬率?」等問題。特別是這些報表可提供廣告端的專屬 ID,因此可用來改善廣告刊登位置。事件層級報表可為機器學習模型提供訓練資料。
- 粗略報表:如果只需要少量的轉換相關資訊,目前點擊轉換資料的上限為 3 位元,也就是說,轉換可獲派八個類別的其中一類;瀏覽轉換資料的上限則為 1 位元。事件層級報表不支援將精細的轉換端資料 (例如特定價格或轉換時間) 進行編碼。
- 詐欺偵測。部分報表中的資料可協助您偵測及分析廣告詐欺行為,瞭解可用於識別垃圾或無效活動的模式。
摘要報表
摘要報表 (舊稱匯總報表) 提供更詳細的轉換資料,且能更彈性地合併點擊或瀏覽資料與轉換資料。
進一步瞭解摘要報表。
news.example 上帶來 518 次轉換,總支出為 $38, 174 美元。shoes.example一半的轉換來自美國紐約市的使用者。摘要報表最適合用於報表用途。這些報表有助於解答「我的投資報酬率是多少?」等問題。
目前正在積極研究如何使用摘要報表進行最佳化,例如針對事件層級報表不支援的購買價值進行最佳化 (因為轉換資料過於粗略)。
其他功能
這項 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 中,必須使用權限政策明確啟用 Attribution Reporting 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 有助於評估兩個已建立連結的事件:發布商網站上的事件,例如有使用者瀏覽或點按廣告,然後在廣告主網站上完成轉換。
事件層級報表
瀏覽器比對點擊或瀏覽,發現與廣告技術定義的轉換資料相符。
產生報表後,瀏覽器會將報表傳送到預先定義的端點,傳送作業可能會有所延遲,也可能會一併傳送一些雜訊。
摘要報表
摘要報表的產生過程如下:
- 使用者點按或瀏覽了特別設定的廣告。該使用者本機裝置上的瀏覽器記錄此事件,並保存預先指定的歸因設定資料。
- 稍後,使用者完成轉換時,瀏覽器會將這個詳細點擊或瀏覽事件 (稱為歸因來源事件) 與轉換詳細資料 (稱為歸因觸發資料) 進行比對。所擷取詳細資料的維度是由廣告技術公司預先定義,瀏覽器會採用廣告技術定義的特定邏輯。瀏覽器會以可匯總報表的形式匯出這項資料。
- 瀏覽器會將可匯總報表加密處理,再傳送到廣告技術伺服器。接著,廣告技術伺服器會將該報表傳送到匯總服務,以便產生摘要報表。
- 廣告技術隨後就能存取摘要報表。請注意,摘要報表的傳送作業不會像事件層級報表一樣有所延遲。
進一步瞭解摘要報表。
隱私權
與第三方 Cookie 不同,廣告公司可透過 Attribution Reporting API 深入瞭解轉換,不必跨網站追蹤個別使用者的活動。
以名為 Bob 的使用者為例。小明在 news.example 上閱讀新聞時看到廣告。一週後,阿斌在
shoes.example上購買鞋子。
目前,系統會使用第三方 Cookie 做為跨網站 ID,追蹤這類轉換。廣告技術公司可透過第三方 Cookie,存取 Bob 在 news.example 和 shoes.example 的活動詳細資料。廣告技術可合併這些資訊,建立 Bob 的詳細資料,包括 Bob 的位置、瀏覽習慣和在 news.example 上偏好的讀物。這個設定檔也可能包含 shoes.example 的購買交易、活動和信用卡資訊。這項跨網站聯結有助於評估廣告轉換。但這會侵犯使用者隱私權:
系統會詳細追蹤 Bob 在各個網站上的活動。
系統會合併少量資訊,足以評估轉換,但不足以詳細追蹤 Bob 在各個網站上的活動。Bob 在 news.example 和 shoes.example 上的活動仍會分開。
每種報表類型提供的保護措施
事件層級報表會將廣告端 ID 與少量轉換端資料建立連結。雖然這些資料會提供跨網站的轉換資訊,但轉換端的資訊過於粗略,無法跨網站加入使用者身分。
摘要報表提供詳細洞察資料,但僅限匯總層級;由於可匯總報表在傳送至廣告技術時會經過加密,因此廣告技術必須使用匯總服務,才能從報表取得任何資訊。匯總服務只會提供含有干擾的匯總資料。
系統會對事件層級和匯總報表套用額外的隱私權保護措施,例如速率限制。
詳細說明:事件層級報表和隱私權
事件層級報表會採用下列隱私權機制,提供轉換洞察資料,且不會跨網站追蹤使用者:
- 系統不會使用跨網站 ID,也不會將詳細的跨網站瀏覽活動資料傳送至裝置外部。
- 事件層級報表會將廣告端的 64 位元資訊 (
news.example) 與轉換端的 1 位元或 3 位元資訊 (shop.example) 建立關聯。64 位元資訊足以對應至個別使用者 ID,但只能連結極少的跨網站資訊:1 位元或 3 位元,不足以保留 ID。- 廣告端的 64 位元並非新資訊,廣告端目前已提供使用者 ID。
news.example或adtech.example已瞭解特定使用者在news.example上的活動。
- 廣告端的 64 位元並非新資訊,廣告端目前已提供使用者 ID。
- 系統會套用額外防護措施,防止濫用和跨網站追蹤:
- 報表會延遲傳送。
- 轉換資料會加入雜訊:系統會以特定百分比的時間產生虛假報表。
- 每次點擊或觀看可產生的歸因轉換報表數量有限。
詳細說明:摘要報表和隱私權
摘要報表會將點擊或瀏覽事件與轉換詳細資料建立關聯。這些 API 會使用下列隱私權機制,在不跨網站追蹤使用者的情況下,提供轉換洞察資料:
- 不使用跨網站 ID。
- 每項歸因都可為產生的摘要報表貢獻多次。特定點擊 (或瀏覽) 和轉換可能會觸發多個歸因。
- 資料會匯總至許多事件 (許多使用者) 的層級,無法精確觀察個別事件。查看匯總資料時,詳細程度越高,資料的相對雜訊也會隨之增加。匯總大量事件和使用者的資料切片,可更準確地保留實用性。
- 將詳細點擊或瀏覽事件與詳細轉換資料建立關聯的原始報表會經過加密,廣告技術公司無法讀取。這項資料只能由匯總服務讀取。
- 系統會套用額外防護措施,防止濫用和跨網站追蹤:
- 系統會隨機延遲傳送報表。
- 對不同資料切片進行的查詢會受到速率限制。
參與討論及分享意見
- 如有 API 相關問題,請在 API 存放區建立問題。
- 如要掌握 API 的最新消息和公告,請訂閱 Attribution Reporting 郵寄清單。
- 如有技術問題,請回報 Chromium 錯誤。