評估廣告點擊或瀏覽促成轉換 (例如廣告客戶網站上的購物) 的時機。
適用對象
以下說明 Attribution Reporting 的基本概念和一些基礎概念,但不會介紹太多技術細節。
- 如果您從事廣告或廣告技術團隊,可以學到這個 API 如何提供第三方 Cookie 的功能。查看 API 用途,進一步瞭解如何產生報表。
- 如果您是開發人員或軟體工程師,請前往完整系統總覽或實驗並參與 API。
採用廣告技術平台的廣告客戶和發布商不需要直接使用這個 API,即可進行轉換評估。您可能會想瞭解如果廣告技術計畫與此 API 整合,歸因報表的運作方式。
什麼是 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 中試用來源試用 |
轉換歷程:跨裝置 說明 |
這個提案已封存。我們目前沒有導入方面的計畫。 |
使用報表驗證功能防範無效的可匯總報表 說明 |
預計於 2024 上半年在 Chrome 推出 |
Attribution Reporting API 權限政策的預設許可清單仍為 * 郵寄清單公告 |
將於 2023 年第 1 季於 Chrome 中使用 |
可設定的事件層級報表架構 GitHub 問題 |
將於 2023 年第 4 季於 Chrome 中使用 |
可匯總報表酬載的邊框間距 更新說明 |
將於 2023 年第 4 季於 Chrome 中使用 |
第 1 階段精簡彈性事件層級 彈性事件層級設定說明 |
將於 2023 年第 4 季推出 Chrome 版本
自訂歸因報表數量和報表回溯期的數量/長度。 可在 2024 年第 1 季於 Chrome 中使用 自訂觸發事件資料的位元數。 |
第三方 Cookie 淘汰後支援 Attribution Reporting 偵錯功能 前往 GitHub 查看意見回饋 |
預計於 2024 上半年在 Chrome 推出 |
支援 Google Cloud 的 Attribution Reporting API 和匯總服務 Attribution Reporting API 說明 匯總服務說明 |
將於 2023 下半年透過 Chrome 使用 |
用途與功能
Attribution Reporting API 提供不同類型的深入分析,其中包含兩種報表,可傳送給廣告客戶或第三方廣告技術供應商。這兩種報表可以同時使用,可以相輔相成。
- 事件層級報表:將特定廣告點擊或觀看 (廣告端) 與轉換端的資料建立關聯。轉換端資料相當有限,而且資料會遭到雜訊,也就是說在少數情況下,系統傳送的是隨機資料,而不是實際報表。這可保護使用者隱私,避免在不同網站之間加入使用者身分。為進一步保障隱私,報表會延遲寄出。
- 摘要報表不會與廣告端的特定事件建立關聯。與事件層級報表相比,這類報表提供更豐富、更精確的轉換資料。多種隱私權技術有助於降低跨網站身分彙整的風險。
事件層級報表
事件層級報表會將廣告點擊或觀看與概略轉換資料建立關聯。
![事件層級報表](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=9&hl=zh-tw)
news.example
上的點擊 ID 200400600 (附加至使用者 ID:news.example
上的使用者 ID Bob_Doe) 是在 shop.example
完成購買。事件層級報表適用於:
- 最佳化。從「如何改善投資報酬率?」等問題獲得解答尤其是,這些報表可用於最佳化廣告刊登位置,因為廣告端的專屬 ID 會在報表中提供。事件層級報表可為機器學習模型提供訓練資料。
- 粗略報表,只提供少量轉換相關資訊。目前點擊次數的轉換資料上限為 3 位元事件層級報表不支援對精細的轉換端資料 (例如特定價格或轉換時間) 編碼。
- 詐欺偵測。部分報表中的資料有助於偵測及分析廣告詐欺活動,可讓您瞭解可用來找出垃圾內容或無效活動的模式。
摘要報表
摘要報表 (舊稱匯總報表) 提供更詳細的轉換資料,且能更靈活地彙整點擊或查看資料和轉換資料。
進一步瞭解摘要報表。
![摘要報表中的深入分析資訊範例。](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=9&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 未在無痕模式下啟用。
- 如果停用第三方 Cookie,API 就無法啟動。
網站如何控管存取權?
如果特定瀏覽器支援這個 API,則根據預設,可在任何指定的網站、頂層文件和指令碼中,以及同來源 iframe 中使用這個 API。
任意第三方 (例如未透過具有頂層存取權指令碼的網頁,加入未加入網頁中的跨來源廣告 iframe) 無法使用發布商或廣告客戶知情,才能在這些 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 可讓您評估兩個相互連結的事件:發布商網站上發生的事件,例如使用者瀏覽或點擊廣告,以及廣告客戶網站上後續發生的轉換。
事件層級報表
![事件層級報表](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=9&hl=zh-tw)
瀏覽器比對點擊或觀看與廣告技術定義的轉換資料。
之後,瀏覽器將產生的報表傳送至預先定義的端點,過程中有些延遲和雜訊。
摘要報表
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=9&hl=zh-tw)
摘要報表的產生方式如下:
- 使用者點按或觀看經過特別設定的廣告。瀏覽器會在使用者本機裝置上記錄這個事件,以及預先指定的歸因設定資料。
- 之後當使用者完成轉換時,瀏覽器會比對這筆詳細點擊或觀看事件 (也就是「歸因來源事件」) 與詳細轉換資料 (又稱「歸因觸發事件資料」)。擷取的詳細資料維度是由廣告技術公司預先定義,瀏覽器會採用廣告技術定義的特定邏輯。瀏覽器會將這項資料輸出至可匯總報表。
- 可匯總報表會由瀏覽器加密,並傳送至廣告技術伺服器。可匯總報表會從廣告技術伺服器傳送至匯總服務,以產生摘要報表。
- 系統隨即會將摘要報表提供給廣告技術。請注意,摘要報表沒有延遲的情況,與事件層級報表的資料延遲時間不會相同。
進一步瞭解摘要報表。
隱私權
有別於第三方 Cookie,Attribution Reporting API 可讓廣告公司不必跨網站追蹤個人活動,即可深入瞭解轉換。
假設一位叫小明的人。博伯在 news.example
閱讀新聞時看到了廣告。一週後,志明在 shoes.example
購買了鞋子。
目前,這項轉換會由做為跨網站 ID 的第三方 Cookie 追蹤。
廣告技術公司可透過第三方 Cookie,存取許多有關 Bob 在 news.example
和 shoes.example
上活動的詳細資料。廣告技術可以合併這些片段,以建立詳細的 Bob 設定檔,包括 Bob 的位置、瀏覽習慣和偏好在 news.example
上讀取的內容。此設定檔也可能包括 shoes.example
上的購買交易、活動和信用卡資訊。因此這項跨網站彙整作業很適合評估廣告轉換。但會降低使用者隱私:
系統會詳細追蹤 Bb 在不同網站的活動。
![並排檢視現今的網路 (加入身分) 和未來的網路 (分區身分)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=9&hl=zh-tw)
我們會將少量資訊彙整到各個網站,這雖然足以評估轉換次數,但不足以追蹤小包跨網站的活動。Bob 的 news.example
和 shoes.example
活動仍各自獨立。
各報表類型的保護措施
事件層級報表會將廣告端 ID 連結至少量轉換資料。雖然這類報表可提供轉換相關的跨網站資訊,但轉換端資訊太過籠統,無法跨網站彙整使用者身分。
摘要報表提供詳細的深入分析,但僅限於匯總層級。因為這些可匯總報表的內容在傳送到廣告技術時都會經過加密,因此廣告技術必須使用匯總服務,才能從報表取得任何資訊。匯總服務只能存取雜訊的匯總資料。
事件層級和匯總報表還會加上頻率限制等額外的隱私保護措施。
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=9&hl=zh-tw)
詳細說明:事件層級報表和隱私權
事件層級報表採用下列隱私權機制,在不跨網站追蹤使用者的情況下,就能提供轉換洞察資料:
- 不會使用跨網站 ID,也不會有詳細的跨網站瀏覽活動離開裝置。
- 事件層級報表會將 64 位元的廣告資訊 (
news.example
) 與轉換端 (shop.example
) 上的 1 位元或 3 位元資訊相連結。64 位元的資訊已足夠對應至個別使用者 ID,但這些 64 位元資訊只與極少的跨網站資訊 (1 位元或 3 位元) 連結,因為這些資料不足以保存 ID。- 廣告端 64 位元不是新資訊。目前廣告位置已可設定 User-ID,
news.example
或adtech.example
已經知道特定使用者在news.example
上的活動。
- 廣告端 64 位元不是新資訊。目前廣告位置已可設定 User-ID,
- 系統會套用額外的保護措施,防範濫用行為和跨網站追蹤:
- 報表傳送時會包含延遲。
- 轉換資料會經過雜訊:產生虛假報表的特定百分比。
- 歸因轉換報表會根據點擊或瀏覽而受到限制。
詳細說明:摘要報表和隱私權
摘要報表會將點擊或瀏覽事件與詳細的轉換資料建立關聯。 該公司透過下列隱私權機制,在不需要跨網站追蹤使用者的情況下提供轉換洞察:
- 未使用跨網站 ID。
- 每項歸因都能為生成的摘要報表做出多次貢獻。任何特定使用者都可以針對特定點擊 (或瀏覽) 和轉換觸發多個歸因。
- 資料會匯總至多個事件 (大量使用者) 的層級,因此無法精準地觀測個別事件。查看匯總資料時,詳細資料層級會因此增加相關資料的相對雜訊。為維持實用性,匯總大量事件和使用者的資料片段會更加準確。
- 將詳細點擊或瀏覽事件與詳細轉換資料建立關聯的原始報表會經過加密,廣告技術公司無法讀取。只有匯總服務才能讀取這項資料。
- 系統會套用額外的保護措施,防範濫用行為和跨網站追蹤:
- 報表傳送時有隨機延遲現象。
- 查詢不同資料配量時,設有頻率限制。
互動及分享意見回饋
- 有關 API 的問題:在 API 存放區上建立問題。
- 您可以追蹤 Attribution Reporting 郵寄清單中的 API 更新和公告。
- 如有技術問題,請回報 Chromium 錯誤。
- 有關實作、整合和一般最佳做法問題:請在 Privacy Sandbox 開發人員支援存放區建立問題。