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

針對關聯性和評估數據的統合式來源試用
透過集合功能整理內容你可以依據偏好儲存及分類內容。

Topics、Fenced Frames 和 Shared Storage。 keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner

Privacy Sandbox 包含多項提案，可讓廣告使用案例不必跨網站追蹤。Origin 試用版可讓開發人員透過實際測試，評估新網路技術並提供意見回饋。Privacy Sandbox Relevance and Measurement 來源試用提供單一試驗，讓網站在 Attribution Reporting、Protected Audience API、Topics、Fenced Frames 和 Shared Storage 中執行統一實驗。開發人員可以註冊這項單一來源試用，以便在 Topics、Protected Audience API 和 Attribution Reporting API 中進行測試。本指南將逐步說明如何設定 API 存取權，並說明如何驗證設定，以及提供其他資源，協助您測試 API。

查看原始測試的狀態

2023 年 6 月

在「穩定版」中，私密匯總功能的 7% 提前啟用

自 2023 年 6 月 6 日星期二起，Private Aggregation API 將開放使用，適用於 7% 的 Chrome 穩定版流量。這個 API 將開放給主要統一來源試驗群組 (5%)、Protected Audience 隔離群組 (1%) 和 Shared Storage 隔離群組 (1%)。由於 Private Aggregation 會加入現有的隔離實驗，因此 Protected Audience 和 Shared Storage 的流量分配不會改變。

自 6 月 6 日星期二起的流量分配：

API	流量分配	狀態
歸因報表	統一 - 5%	截至 2023 年 3 月 13 日，穩定流量占比 6%
	隔離 - 1% - 僅限 ARA
圍欄頁框	統一 - 5%	截至 2023 年 3 月 13 日，佔穩定流量的 7%
	隔離 - 1% - 僅限共用儲存空間 + 私密匯總 + 隔離畫面
	隔離 - 1% - Protected Audience + Private Aggregation + Fenced Frames only
Protected Audience	統合 - 5%	截至 2023 年 3 月 13 日，穩定流量占比 6%
	隔離 - 1% - Protected Audience + Private Aggregation + Fenced Frames only
私密匯總	統合 - 5%	截至 2023 年 6 月 6 日，穩定流量占比 7%
	隔離 - 1% - Protected Audience + Private Aggregation + Fenced Frames only
	隔離 - 1% - 僅限 Shared Storage + Private Aggregation + Fenced Frames
共用儲存空間	統一 - 5%	截至 2023 年 3 月 13 日，穩定流量占比 6%
	隔離 - 1% - 僅限共用儲存空間 + 私密匯總 + 隔離畫面
主題	統一 - 5%	截至 2023 年 3 月 13 日，穩定流量占比 6%
	隔離 - 1% - 僅限主題

先前的更新內容

請查看先前有關原點試驗的更新內容。

2023 年 4 月

在穩定版中，私密匯總 1% 的逐步增加

自 4 月 17 日星期一起，Chrome 穩定版統一實驗流量的 1% 將開放 Private Aggregation API 來源試用。Private Aggregation 的 sendHistogramReport() 函式可用於 Protected Audience API 和 Shared Storage 工作區塊。

自 4 月 17 日星期一起，流量分配如下：

API	流量分配	狀態
歸因報表	統一 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	隔離 - 1% - 僅限 ARA
圍欄頁框	統一 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 7%
	隔離 - 1% - 共用儲存空間 (網址選取) + 僅限區隔畫面
	隔離 - 1% - 僅限 Protected Audience API + 隔離框架
Protected Audience API	統一 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	隔離 - 1% - 僅限 Protected Audience API + 隔離框架
私密匯總	統合 - 1%	自 2023 年 4 月 17 日起，穩定流量的 1%
共用儲存空間 (網址選取)	統一 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	隔離 - 1% - 共用儲存空間 (網址選取) + 僅限區隔畫面
主題	統一 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	隔離 - 1% - 僅限主題

2023 年 3 月

時間軸更新

我們最初表示，將在 2023 年 3 月 13 日星期一開始進行獨立實驗，但由於設定實驗需要額外時間，因此新實驗將在 2023 年 3 月 16 日星期四開始。2023 年 3 月 16 日星期四，Protected Audience API 的 1% 費率也將從 4% 調高至 5%。

Protected Audience API 1% 逐步恢復

上個月，我們暫時將 Protected Audience API 來源試用流量從 Chrome 穩定版的 5% 降至 4%，以便進行測試。初步測試已結束，我們預計在 2023 年 3 月 16 日星期四，將統一實驗的 Protected Audience API 從 4% 提高至 5%。

這類使用者與降級的使用者相同。不過，由於降載後已超過 30 天，因此先前的興趣群組已失效。

隔離實驗

為了改善測試程序，並持續觀察原始試用版 API 的指標，我們除了現有的統一實驗外，也為每個 API 建立獨立實驗。我們將針對 Attribution Reporting、Topics、Protected Audience API 和 Fenced Frames 的組合，以及 Shared Storage 的網址選取作業和 Fenced Frames 的組合，建立新的實驗。在每個獨立實驗中，只有指派的 API 可供該群組中的使用者使用。

API	隔離實驗流量分配
歸因報表	1%
Protected Audience API + Fenced Frame	1%
共用儲存空間 (網址選取) + 區隔框架	1%
主題	1%

自 3 月 16 日星期四起，您將開始收到上述 API 的額外 1% Chrome 穩定版流量，加上您從現有統一實驗收到的 5% 流量。系統會將新使用者分配給各個實驗。

流量分配

截至 2 月 28 日星期二，目前的統一來源測試流量分配如下：

API	目前的統合實驗流量分配
歸因報表	5%
圍欄頁框	5%
Protected Audience API	4%
共用儲存空間 (網址選項)	5%
主題	5%

在 Protected Audience API 恢復運作，並開始新的隔離實驗後，自 3 月 16 日星期四起，流量分配會如下所示：

API	新的流量分配	狀態
歸因報表	統一 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 6%
歸因報表	隔離 - 1% - 僅限 ARA	自 2023 年 3 月 16 日起，穩定版流量的 6%
圍欄頁框	統一 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 7%
	隔離 - 1% - 共用儲存空間 (網址選取) + 僅限區隔畫面
	隔離 - 1% - 僅限 Protected Audience API + 隔離框架
Protected Audience API	統一 - 5% (目前分配 4% + 1% 逐步恢復)	自 2023 年 3 月 16 日起，穩定版流量的 6%
Protected Audience API	隔離 - 1% - 僅限 Protected Audience API + 隔離框架	自 2023 年 3 月 16 日起，穩定版流量的 6%
共用儲存空間 (網址選項)	統一 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 6%
共用儲存空間 (網址選項)	隔離 - 1% - 共用儲存空間 (網址選取) + 僅限區隔畫面	自 2023 年 3 月 16 日起，穩定版流量的 6%
主題	統一 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 6%
主題	隔離 - 1% - 僅限主題	自 2023 年 3 月 16 日起，穩定版流量的 6%

這些變更不會影響現有的來源試用權杖設定，您也不需要續訂或產生新的來源試用權杖。

2023 年 1 月

為調查 Chrome 回歸問題，我們將從 2023 年 1 月 26 日起，暫時將 Protected Audience API 來源試用流量從 Chrome 穩定版的 5% 降至 4%。我們預估調查作業需要約一個月，並會在流量恢復後通知你。

這項異動會自動生效，且不會影響現有的原始試用權杖。對於流量將減少 1% 的使用者，興趣群組仍會保留在瀏覽器中。同樣的使用者會加入回升計畫，因此可以重複使用他們的興趣群組。不過，興趣群組會在 30 天後到期，而回歸調查可能需要更長的時間。

此外，自 2023 年 1 月 26 日起，Shared Storage 的 URL Selection API 來源試用將增加至 Chrome 穩定版流量的 5%。

API	附註
歸因報表	已在穩定版中推出，自 2022 年 10 月 26 日起調高至 5%。
主題	已在穩定版中推出，自 2022 年 10 月 26 日起調高至 5%。
Protected Audience API	已在穩定版中推出，自 2023 年 1 月 26 日起暫時調降至 4%。
Fenced Frames	已在穩定版中推出，並自 2022 年 11 月 9 日起調高至 5%。
共用儲存空間	已在穩定版中推出，自 2023 年 1 月 26 日起調高 5%。

2022 年 11 月

自 11 月 9 日起，Shared Storage 的 `selectURL` API 將加入 Chrome 穩定版流量 1% 的來源試用。

如先前在將 Privacy Sandbox 相關性和成效評估來源試用計畫的參與比例提高至 5% 的部落格文章中所述，Attribution Reporting 和 Topics 目前的參與比例為 5%，Protected Audience API 和 Fenced Frames 則會在 11 月 9 日加入。

API	附註
歸因報表	已在穩定版中推出，自 10 月 26 日起調高至 5%。
主題	已在穩定版中推出，自 10 月 26 日起調高至 5%。
Protected Audience API	已在穩定版中推出，自 11 月 9 日起調高至 5%。
Fenced Frames	已在穩定版中推出，自 11 月 9 日起調高至 5%。
共用儲存空間	自 11 月 9 日起，穩定版將提供 1% 的更新率。

2022 年 10 月：調高 5%

Attribution Reporting、Topics、Protected Audience API 和 Fenced Frames 目前皆已在 Chrome 穩定版中提供，並會納入流量增加的範圍。

我們將從本週開始增加 Attribution Reporting 和 Topics 的流量，Protected Audience API 和 Fenced Frames 則會從 11 月 9 日開始增加。

詳情請參閱「將 Privacy Sandbox 關聯性和評估來源試驗計畫的比例提高至 5%」網誌文章。

API	附註
歸因報表	已在穩定版中推出，10 月 26 日後將調高至 5%。
主題	已在穩定版中推出，10 月 26 日後將調高至 5%。
Protected Audience API	已在穩定版中推出，自 11 月 9 日起調高至 5%。
Fenced Frames	已在穩定版中推出，自 11 月 9 日起調高至 5%。
共用儲存空間	目前僅適用於 M105 以上的 Canary、Dev 和 Beta 版。

2022 年 10 月

來源試用已延長至 Chrome 110。
開始使用 Chrome 來源試用說明如何續訂來源試用註冊。這包括向參與的來源提供新的權杖，這與任何其他來源試用擴充功能的程序相同。

我們延長了這項功能的推出時間，讓穩定版通道的生態系統有時間繼續測試及驗證 API 改善項目，同時提供與現有公開時間表一致的意見回饋。

整體 Privacy Sandbox 時程保持不變。

試用方案包含的 API：

API	附註
歸因報表	原始試用版開發人員指南。
Protected Audience API	原始試用版開發人員指南。
主題	原始試用版開發人員指南。
Fenced Frames	請參閱 Protected Audience API 指南，瞭解來源試用功能的使用方式。
共用儲存空間	目前僅適用於 M105 以上的 Canary、Dev 和 Beta 版。

2022 年 8 月

來源試用功能的適用對象將擴大至 1% 的 Chrome 穩定版 104 桌面使用者。
當這項功能開放行動使用者後，我們會隨即發布更新。
穩定版前管道 (Canary、Beta) 的使用者比例維持在 50%。
API 不適用於 iOS 版 Chrome。

2022 年 5 月

Chrome 102 Beta 版的 50% 使用者可使用來源試用功能。

試用方案包含的 API：

API	附註
歸因報表	原始試用版開發人員指南。
Protected Audience API	原始試用版開發人員指南。
主題	原始試用版的開發人員指南。由於影響瀏覽器穩定性的錯誤，主題功能在原始測試期間曾短暫停用。
Fenced Frames	已將 Fenced Frames 新增至來源試用計畫。請參閱 Protected Audience API 指南，瞭解如何使用實驗。

2022 年 4 月

起源試驗計畫一開始只會針對 Chrome 102 Beta 版的部分使用者進行。

試用方案包含的 API：

API	附註
歸因報表	個別意圖到實驗 (I2E) 文章。歸因報表也提供個別來源試用版。
Protected Audience API	個別意圖到實驗 (I2E) 文章。Protected Audience API 僅適用於電腦版，且僅提供部分功能。
主題	個別意圖進行實驗 (I2E) 貼文。

註冊及設定來源試用

如要在網站上啟用來源試用功能，您必須註冊並嵌入指派的來源試用權杖 (以時間為依據的字串，可讓您存取來源試用功能)。如要進一步瞭解相關資訊，請參閱「開始使用 Chrome 來源試驗」。

來源試用權代碼會立即授予，您隨時可以撤銷或重新建立。

對於每個要使用來源測試的網頁，您都必須在該特定網頁的 HTML 或回應中加入測試權杖。

在網頁的 <head> 部分使用 <meta> 標記：

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

或者，您也可以在網頁回應中加入下列 HTTP 標頭：

Origin-Trial: TOKEN_GOES_HERE

使用 iframe 進行設定

如果您在 iframe (例如 Protected Audience API 的 joinAdInterestGroup()) 中使用來源試用功能，則需要在 iframe 中提供權杖，並與 iframe 的來源相符。

使用 JavaScript 設定跨網站

如果您是透過跨網站 JavaScript 使用來源測試功能 (例如您是頂層網頁中所含第三方 JavaScript 的供應商)，則需要執行以下操作：

註冊原始試用方案時，請選取「第三方比對」選項。
「網頁來源」欄位應為指令碼的來源。
將 <meta> 標記從指令碼插入頂層網頁 (即第一方網頁，而非您自己的內容)。例如：

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

偵錯來源試用

您可以在「DevTools」 >「Applications」面板中查看來源測試的狀態。

向下捲動至「Frames」窗格。
選取要設定符記的時間點。例如，頂層網頁的頂層框架，或嵌入式網頁的特定 iframe。
在右側面板中，向下捲動至「Origin Trials」部分。
您應該會看到 PrivacySandboxAdsAPIs 試用方案的項目。
展開這個項目，即可查看來源試用和特定符記的狀態。

這項原點試驗僅限於部分 Chrome 使用者，您的瀏覽器可能不在實驗群組中。因此，您可能會在 PrivacySandboxAdsAPIs 旁看到紅色的 TrialNotAllowed 訊息。展開項目檢查權杖狀態時，如果顯示綠色 Success 訊息，表示原始試用版設定正確無誤。符合資格的使用者會看到訊息設定為 Enabled。

如果您看到其他訊息，請參閱「排解 Chrome 的來源測試問題」一文，取得詳細的檢查清單，驗證您對來源測試的設定。

偵測功能

如同所有網頁功能，您應先確認瀏覽器是否有提供這些功能，再嘗試使用。您可以透過檢查相關 API 是否位於正確位置來完成此操作：

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting enabled
}

if ('runAdAuction' in navigator) {
  // Protected Audience API enabled
}

if ('browsingTopics' in document) {
  // Topics enabled
}

if ('HTMLFencedFrameElement' in window) {
  // Fenced Frames enabled
}

if ('sharedStorage' in window) {
  // Shared Storage enabled
}

if (window?.sharedStorage?.selectURL instanceof Function) {
  // optionally check specifically for the selectURL function in Shared Storage
}

判斷使用者是否符合資格

目前只有部分 Chrome 使用者參與來源試驗。他們也必須在設定中啟用相關功能，才能符合試用資格：

瀏覽器設定

使用者必須符合下列條件，才能享有試用方案：

使用 Chrome 的版本和開發版本，並執行來源試用功能。
- 如要查看目前的設定，請參閱「Origin Trial 狀態」。
屬於 Chrome 中的有效實驗群組。

使用者設定

使用者必須符合下列條件，才能享有試用方案：

透過「設定」>「安全性和隱私權」>「Privacy Sandbox」啟用 Privacy Sandbox 試用功能，也可以透過 chrome://settings/adPrivacy 存取。
透過「設定」>「安全性和隱私權」>「Cookie 和其他網站資料」將第三方 Cookie 啟用，並設為「允許所有 Cookie」或「在無痕模式中封鎖第三方 Cookie」，也可以透過 chrome://settings/cookies 存取。
使用標準瀏覽工作階段，而非無痕模式。

雖然原始試用版只會向符合資格的使用者顯示為有效，但您也可以使用開發人員標記，針對自己的正式網站進行測試。

控管參與來源試用功能

原始測試的機制仍維持不變：您會針對要實驗 API 的內容取得原始測試權杖。由於測試對象人數增加，您應確保積極監控並控制選擇啟用試用版的流量等級。

這裡的最佳做法如下：

根據預設，在您要進行實驗的所有情境中加入來源測試代碼。
使用功能偵測功能，檢查是否有啟用的 API。
如果 API 處於啟用狀態 (因此瀏覽器符合這項實驗的資格)，請根據您自己的實驗標準選擇是否要使用這些 API。舉例來說，如果您已設有 A/B 測試基礎架構，可針對一定比例的流量、取樣或其他屬性進行實驗，那麼您就可以決定要積極使用哪些功能。

您可以透過在回應中不納入權杖，完全避免任何瀏覽器執行個體參與原始試驗。舉例來說，如果您已達到實驗配額，或是需要在試用期間解決問題，則不含代碼可確保網頁中不會提供或啟用任何實驗功能。

依地理區域控制來源試用

您無法選擇不參與特定區域的原始試用。原點測試會在含有權杖的網頁上啟用，這些權杖是透過 HTTP 標頭 (伺服器端) 或 HTML 中繼標記 (用戶端) 加入。

如果您可以判斷使用者的所在位置，則可以編寫程式碼，根據該位置資訊加入原始試用權代碼。舉例來說，您可以嘗試使用 IP 位址判斷使用者的所在位置。IP 位址可能會遭到冒用，因此這並非保證可行的解決方案。

不過，地理位置特定來源可以設定權限政策，控管可使用的功能。舉例來說，us.example.com 和 uk.example.com 是可控管的地理位置特定來源。這並不表示該地區已選擇不參與來源試用。

有了權限政策，網站就能在網頁中加入一小段程式碼，為瀏覽器提供指示。網頁載入時，瀏覽器會讀取權限政策指示，並根據權限政策的規定允許或封鎖功能 (或 API)。如果網站想要限制特定區域的 API，開發人員可以為該區域要求的所有網頁設定政策。

續購權杖

Origin 試用權杖會在發出日期後六週失效 (如果試用期結束時間較早，則會在試用期結束時失效)。

請務必在該期間重新發布並部署新的權杖，以便持續使用原始試用版功能。

重新發出權杖只需要幾分鐘的時間，您可以在同一個頁面中為同一項試用方案部署多個權杖。您可以在現有權杖到期前部署更新的權杖，這樣使用者就不會中斷服務。

本機測試

如需本機開發人員測試的具體指南，請參閱：

這些 API 預設為關閉，必須使用標記啟用才能進行測試。請確認您已啟用上述相同的設定，然後執行下列操作：

使用支援這些功能的 Chrome 版本和開發人員版本。
啟用 chrome://settings/adPrivacy 下方的所有廣告隱私權 API。

請參閱開發人員指南，瞭解特定 API 和功能是否可用，以及其他旗標可用於更精細的設定。

針對關聯性和評估數據的統合式來源試用 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

查看原始測試的狀態

2023 年 6 月

在「穩定版」中，私密匯總功能的 7% 提前啟用

先前的更新內容

2023 年 4 月

在穩定版中，私密匯總 1% 的逐步增加

2023 年 3 月

時間軸更新

Protected Audience API 1% 逐步恢復

隔離實驗

流量分配

2023 年 1 月

2022 年 11 月

2022 年 10 月：調高 5%

2022 年 10 月

2022 年 8 月

2022 年 5 月

2022 年 4 月

註冊及設定來源試用

使用 iframe 進行設定

使用 JavaScript 設定跨網站

偵錯來源試用

偵測功能

判斷使用者是否符合資格

瀏覽器設定

使用者設定

控管參與來源試用功能

依地理區域控制來源試用

續購權杖

本機測試

針對關聯性和評估數據的統合式來源試用
透過集合功能整理內容你可以依據偏好儲存及分類內容。